emacs-30 54071b9cef2: ; Improve doc strings of 'tab-bar-mode' and 'tab-line-mode'

[Eli Zaretskii]

branch: emacs-30
commit 54071b9cef287ac6826d67534d0c5c935bbca78c
Author: Eli Zaretskii <eliz@gnu.org>
Commit: Eli Zaretskii <eliz@gnu.org>

    ; Improve doc strings of 'tab-bar-mode' and 'tab-line-mode'
    
    * lisp/tab-line.el (tab-line-mode):
    * lisp/tab-bar.el (tab-bar-mode): Doc fixes (bug#73049)
---
 lisp/tab-bar.el  | 10 +++++++++-
 lisp/tab-line.el | 10 +++++++++-
 2 files changed, 18 insertions(+), 2 deletions(-)

diff --git a/lisp/tab-bar.el b/lisp/tab-bar.el
index 718ddfd2e88..ea36a924c78 100644
--- a/lisp/tab-bar.el
+++ b/lisp/tab-bar.el
@@ -257,7 +257,15 @@ a list of frames to update."
   "Tab Bar mode map.")
 
 (define-minor-mode tab-bar-mode
-  "Toggle the tab bar in all graphical frames (Tab Bar mode)."
+  "Toggle the tab bar in all graphical frames (Tab Bar mode).
+
+When this mode is enabled, Emacs displays a tab bar on top of each frame.
+The tab bar is a row of tabs -- buttons that you can click
+to switch the frame between different window configurations.
+See `current-window-configuration' for more about window configurations.
+To add a button (which can then record one more window configuration),
+click on the \"+\" button.  Clicking on the \"x\" icon of a button
+deletes the button."
   :global t
   ;; It's defined in C/cus-start, this stops the d-m-m macro defining it again.
   :variable tab-bar-mode
diff --git a/lisp/tab-line.el b/lisp/tab-line.el
index 462a0a27692..92b52b6936c 100644
--- a/lisp/tab-line.el
+++ b/lisp/tab-line.el
@@ -1141,7 +1141,15 @@ However, return the correct mouse position list if EVENT 
is a
 
 ;;;###autoload
 (define-minor-mode tab-line-mode
-  "Toggle display of tab line in the windows displaying the current buffer."
+  "Toggle display of tab line in the windows displaying the current buffer.
+
+When this mode is enabled, each window displays a tab line on its
+top screen line.  The tab line is a row of tabs -- buttons which
+you can click to have the window display the buffer whose name is
+shown on the button.  Clicking on the \"x\" icon of the button
+removes the button (but does not kill the corresponding buffer).
+In addition, the tab line shows a \"+\" button which adds a new
+button, so you could have one more buffer shown on the tab line."
   :lighter nil
   (let ((default-value '(:eval (tab-line-format))))
     ;; Preserve the existing tab-line set outside of this mode