* doc/emacs/frames.texi (Tab Bars): Add text about mouse and tab-bar-format

Briefly describe mouse commands on the tab bar and tab-bar-format (bug#51444)

diff --git a/doc/emacs/frames.texi b/doc/emacs/frames.texi
index 3514821cc7d0f78acf9b9e0ed71ac5bf98f50660..c14ada29576331cbc4fe69ee79c4cc9c1f425a64 100644 (file)
--- a/doc/emacs/frames.texi
+++ b/doc/emacs/frames.texi
@@ -1508,6 +1508,13 @@ to the right; with a negative argument @minus{}@var{n}, move it
 @var{n} positions to the left.
 @end table
 
+  You can use the mouse to operate on tabs.  Clicking @kbd{mouse-2}
+closes the tab.  Clicking @kbd{mouse-3} pops up the context menu with
+the items that operate on the clicked tab.  Dragging the tab with
+@kbd{mouse-1} moves it to another position on the tab bar.  Mouse
+wheel scrolling switches to the next or previous tab.  Holding down
+the @key{SHIFT} key during scrolling moves the tab to the left or right.
+
 @findex tab-bar-history-mode
   You can enable @code{tab-bar-history-mode} to remember window
 configurations used in every tab, and later restore them.
@@ -1524,6 +1531,9 @@ Cancel restoration of the previous window configuration.
 This moves forward in the history of window configurations.
 @end table
 
+  It's possible to customize the items displayed on the tab bar
+by the user option @code{tab-bar-format}.
+
 @node Dialog Boxes
 @section Using Dialog Boxes
 @cindex dialog boxes

diff --git a/etc/NEWS b/etc/NEWS
index 54a099d0ef2896e77e48846762f08539357d20e9..dc1eb86c6f004a2c207dd05e74e761900e3aeb5f 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -486,6 +486,7 @@ command 'other-tab-prefix'.
 +++
 *** New command 'C-x t C-r' to open file read-only in the other tab.
 
++++
 *** The tab bar now supports more mouse commands.
 Clicking 'mouse-2' closes the tab, 'mouse-3' displays the context menu
 with items that operate on the clicked tab.  Dragging the tab with
@@ -506,7 +507,7 @@ frame regardless of the values of 'tab-bar-mode' and 'tab-bar-show'.
 This allows enabling/disabling the tab bar independently on different
 frames.
 
----
++++
 *** New user option 'tab-bar-format' defines a list of tab bar items.
 When it contains 'tab-bar-format-global' (possibly appended after
 'tab-bar-format-align-right'), then after enabling 'display-time-mode'