From 9cf8454463ab0249c3b680f892507743b3be972e Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Sat, 5 Oct 2019 16:03:43 +0300 Subject: [PATCH] Improve documentation of Tab bars * doc/emacs/frames.texi (Menu Bars, Tool Bars, Tab Bars): Don't start index entries from a capital letter. (Tab Bars): Improve wording and indexing. * etc/NEWS: Improve documentation of Tab bars. --- doc/emacs/frames.texi | 58 +++++++++++++++++++++---------------------- etc/NEWS | 51 +++++++++++++++++++------------------ 2 files changed, 53 insertions(+), 56 deletions(-) diff --git a/doc/emacs/frames.texi b/doc/emacs/frames.texi index 0cb9c4eb1d7..2acc65c189a 100644 --- a/doc/emacs/frames.texi +++ b/doc/emacs/frames.texi @@ -1152,7 +1152,7 @@ cursor during dragging. To suppress such behavior, set the options @node Menu Bars @section Menu Bars -@cindex Menu Bar mode +@cindex menu bar mode @cindex mode, Menu Bar @findex menu-bar-mode @vindex menu-bar-mode @@ -1177,7 +1177,7 @@ menus' visual appearance. @node Tool Bars @section Tool Bars -@cindex Tool Bar mode +@cindex tool bar mode @cindex mode, Tool Bar @cindex icons, toolbar @@ -1217,50 +1217,48 @@ displayed by moving the mouse pointer to the top of the screen. @node Tab Bars @section Tab Bars -@cindex Tab Bar mode +@cindex tab bar mode @cindex mode, Tab Bar @cindex tabs, tabbar - On graphical displays and on text terminals, Emacs puts a @dfn{tab bar} -at the top of each frame, just below the menu bar. This is a row of -tabs which you can click on with the mouse to switch window configurations. + On graphical displays and on text terminals, Emacs can optionally +display a @dfn{Tab Bar} at the top of each frame, just below the menu +bar. The Tab Bar is a row of @dfn{tabs}---buttons that you can click +to switch between window configurations on that frame. - Each tab on the tab bar represents a named persistent window -configuration. Its name is composed from the names of buffers -visible in windows of the window configuration. Clicking on the -tab name switches the current window configuration to the previously -used configuration of windows and buffers. + Each tab on the Tab Bar represents a named persistent window +configuration. Its name is composed from the list of names of buffers +visible in windows of that window configuration. Clicking on the tab +switches to the window configuration recorded by the tab; it is a +configuration of windows and buffers which was previously used in the +frame when that tab was the current tab. If you are using the desktop library to save and restore your -sessions, the tabs from the tab bar are recorded in the desktop file, -together with their associated window configurations. +sessions (@pxref{Saving Emacs Sesions}), the tabs from the Tab Bar are +recorded in the desktop file, together with their associated window +configurations, and will be available after restoring the session. @findex tab-bar-mode -@vindex tab-bar-mode To toggle the use of tab bars, type @kbd{M-x tab-bar-mode}. This command applies to all frames, including frames yet to be created. To control the use of tab bars at startup, customize the variable @code{tab-bar-mode}. @vindex tab-bar-show -@cindex Tab Bar show - This variable is intended to toggle the tab bar automatically. -When the value is @code{t}, then @code{tab-bar-mode} is enabled when -using the commands that create new window configurations. The value -@code{1} hides the tab bar when it has only one tab, and shows it -again once more tabs are created. If @code{nil}, always keep the tab -bar hidden. In this case it's still possible to use persistent named -window configurations without using the tab bar by relying on keyboard -commands that create a new window configuration (@kbd{M-x tab-new}), -that switch windows configurations (@kbd{M-x tab-next}, @kbd{M-x -tab-list}), or delete the existing ones (@kbd{M-x tab-close}). + The variable @code{tab-bar-show} controls whether the Tab Bar mode +is turned on automatically. If the value is @code{t}, then +@code{tab-bar-mode} is enabled when using the commands that create new +tabs. The value @code{1} hides the tab bar when it has only one tab, +and shows it again when more tabs are created. The value @code{nil} +always keeps the tab bar hidden; in this case it's still possible to +use persistent named window configurations without using the tab bar +by typing the related commands: @kbd{M-x tab-new}, @kbd{M-x tab-next}, +@kbd{M-x tab-list}, @kbd{M-x tab-close}, etc. @vindex tab-bar-new-tab-choice -@cindex Tab Bar new tab - By default, Emacs follows the same behavior as when creating frames, -to start a new tab with the current buffer, i.e. the buffer -that was current before calling the command that adds a new tab. -To start a new tab with other buffers, customize the variable + By default, a new tab starts with the current buffer that was +current before calling the command that adds a new tab. To start a +new tab with other buffers, customize the variable @code{tab-bar-new-tab-choice}. @node Dialog Boxes diff --git a/etc/NEWS b/etc/NEWS index db90e8e5c54..cadd6d9ef4b 100644 --- a/etc/NEWS +++ b/etc/NEWS @@ -2040,33 +2040,32 @@ file-local variable, you may need to update the value. * New Modes and Packages in Emacs 27.1 -** 'tab-bar-mode' enables the tab-bar at the top of each frame, -to switch named persistent window configurations in it using tabs. -New tab-based keybindings (similar to frame-based commands): -'C-x 6 2' creates a new tab; -'C-x 6 0' deletes the current tab; -'C-x 6 b' switches to buffer in another tab; -'C-x 6 f' and 'C-x 6 C-f' edit file in another tab; -'C-TAB' switches to the next tab; -'S-C-TAB' switches to the previous tab. - -Also it's possible to switch named persistent window configurations -without having graphical access to the tab-bar, even on a tty -or when 'tab-bar-mode' is disabled, with these commands: -'tab-new' creates a new window configuration; -'tab-close' deletes the current window configuration; -'tab-select' switches to the window configuration by its name; -'tab-previous' switches to the previous window configuration; -'tab-next' switches to the next window configuration; -'tab-list' displays a list of named window configurations for switching. - -** 'global-tab-line-mode' enables the tab-line above each window to -switch buffers in it to previous/next buffers. Selecting a previous -window-local tab is the same as running 'C-x ' (previous-buffer), -selecting a next tab switches to the tab available by 'C-x ' +** Tab Bars + ++++ +*** Tab-Bar mode +The new command 'tab-bar-mode' enables the tab-bar at the top of each +frame, where you can use tabs to switch between named persistent +window configurations. + +The 'C-x 6' sequence is the new prefix key for tab-related commands: +'C-x 6 2' creates a new tab; 'C-x 6 0' deletes the current tab; +'C-x 6 b' switches to buffer in another tab; 'C-x 6 f' and 'C-x 6 C-f' +edit file in another tab; and 'C-TAB' and 'S-C-TAB' switch to the next +or previous tab. You can also switch between tabs and create/delete +tabs with a mouse. + +Tab-related commands are available even when the Tab-Bar mode is +disabled: by default, they enable Tab-Bar mode in that case. + +*** Tab-Line mode +The new command 'global-tab-line-mode' enables the tab-line above each +window, which you can use to switch buffers in the window. Selecting +the previous window-local tab is the same as typing 'C-x ' +(previous-buffer), selecting the next tab is the same as 'C-x ' (next-buffer). Clicking on the plus icon adds a new buffer to the -window-local tab-line of window buffers. Using the mouse wheel on the -tab-line scrolls the window buffers whose names are displayed in tabs. +window-local tab-line of buffers. Using the mouse wheel on the +tab-line scrolls tabs that display the window buffers. ** fileloop.el lets one setup multifile operations like search&replace. -- 2.39.5