emacs-28 c163fd9: Minor fixes for recent changes in ELisp manual

[Eli Zaretskii]

branch: emacs-28
commit c163fd9260317adbb85a2274dab795a6a7f3061f
Author: Eli Zaretskii <eliz@gnu.org>
Commit: Eli Zaretskii <eliz@gnu.org>

    Minor fixes for recent changes in ELisp manual
    
    * doc/lispref/windows.texi (Basic Windows, Windows and Frames)
    (Selecting Windows):
    * doc/lispref/objects.texi (Window Type):
    * doc/lispref/frames.texi (Input Focus, Frame Layout): Fix
    wording, punctuation, and indexing.
---
 doc/lispref/frames.texi  |  7 ++++---
 doc/lispref/objects.texi |  2 +-
 doc/lispref/windows.texi | 28 +++++++++++++++-------------
 lisp/tab-bar.el          | 24 ++++++++++++++----------
 4 files changed, 34 insertions(+), 27 deletions(-)

diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi
index 2c3a58d..f851d12 100644
--- a/doc/lispref/frames.texi
+++ b/doc/lispref/frames.texi
@@ -644,8 +644,9 @@ accommodate an overlong tool bar.
 @item Tab Bar
 @cindex internal tab bar
 The tab bar (@pxref{Tab Bars,,,emacs, The GNU Emacs Manual}) is always
-drawn by Emacs itself.  On builds with internal tool bars, the tab bar
-appears above the tool bar, on builds with external tool bars below.
+drawn by Emacs itself.  The tab bar appears above the tool bar in
+Emacs built with an internal tool bar, and below the tool bar in
+builds with an external tool bar.
 Display of the tab bar can be suppressed by setting the
 @code{tab-bar-lines} parameter (@pxref{Layout Parameters}) to zero.
 
@@ -3009,7 +3010,7 @@ Auto-selection}).
 
 Note that this option does not distinguish ``sloppy'' focus (where the
 frame that previously had focus retains focus as long as the mouse
-pointer does not move into another window system window) from ``strict''
+pointer does not move into another window-system window) from ``strict''
 focus (where a frame immediately loses focus when it's left by the mouse
 pointer).  Neither does it recognize whether your window manager
 supports delayed focusing or auto-raising where you can explicitly
diff --git a/doc/lispref/objects.texi b/doc/lispref/objects.texi
index 2b82e03..0551bb5 100644
--- a/doc/lispref/objects.texi
+++ b/doc/lispref/objects.texi
@@ -1625,7 +1625,7 @@ markers.
 @node Window Type
 @subsection Window Type
 
-  A @dfn{window} describes a portion of the screen that Emacs uses to
+  A @dfn{window} describes the portion of the screen that Emacs uses to
 display buffers.  Every live window (@pxref{Basic Windows}) has one
 associated buffer, whose contents appear in that window.  By contrast, a
 given buffer may appear in one window, no window, or several windows.
diff --git a/doc/lispref/windows.texi b/doc/lispref/windows.texi
index c4bb4e6..c66ae17 100644
--- a/doc/lispref/windows.texi
+++ b/doc/lispref/windows.texi
@@ -65,15 +65,15 @@ another window.
 
 @cindex terminal screen
 @cindex screen of terminal
-@cindex window system window
+@cindex window-system window
   Emacs uses the term ``window'' with a different meaning than in
 graphical desktop environments and window systems, such as the X Window
 System.  When Emacs is run on X, each graphical X window owned by the
 Emacs process corresponds to one Emacs frame.  When Emacs is run on a
 text terminal, each Emacs frame fills the entire terminal screen.  In
 either case, the frame may contain one or more Emacs windows.  For
-disambiguation, we use the term @dfn{window system window} when we mean
-the window system window corresponding to an Emacs frame.
+disambiguation, we use the term @dfn{window-system window} when we mean
+the window-system window corresponding to an Emacs frame.
 
 @cindex tiled windows
   Unlike X windows, Emacs windows are @dfn{tiled}; they never overlap
@@ -82,7 +82,8 @@ deleted, the change in window space is taken from or given to 
other
 windows on the same frame, so that the total area of the frame is
 unchanged.
 
-In Emacs Lisp, windows are represented by a special Lisp object type.
+In Emacs Lisp, windows are represented by a special Lisp object type
+(@pxref{Window Type}).
 
 @defun windowp object
 This function returns @code{t} if @var{object} is a window (whether or
@@ -212,7 +213,7 @@ window} which is used for displaying a tooltip in a tooltip 
frame
 
 Each window belongs to exactly one frame (@pxref{Frames}).  For all
 windows belonging to a specific frame, we sometimes also say that these
-windows are owned by that frame or simply that they are on that frame.
+windows are @dfn{owned} by that frame or simply that they are on that frame.
 
 @defun window-frame &optional window
 This function returns the specified @var{window}'s frame---the frame
@@ -251,14 +252,15 @@ the first element.
 whose leaf nodes are the live windows.  The internal nodes of a window
 tree are not live; they exist for the purpose of organizing the
 relationships between live windows.  The root node of a window tree is
-called the @dfn{root window}.  It is either a live window (if the frame
-has just one window besides the minibuffer window or the frame is a
-minibuffer-only frame, see @ref{Frame Layout}), or an internal window.
+called the @dfn{root window}.  It is either a live window or an
+internal window.  If it is a live window, then the frame has just one
+window besides the minibuffer window, or the frame is a
+minibuffer-only frame, @pxref{Frame Layout}.
 
   A minibuffer window (@pxref{Minibuffer Windows}) that is not alone on
 its frame does not have a parent window, so it strictly speaking is not
 part of its frame's window tree.  Nonetheless, it is a sibling window of
-the frame's root window, and thus can be reached from there via
+the frame's root window, and thus can be reached from the root window via
 @code{window-next-sibling}, see below.  Also, the function
 @code{window-tree} described at the end of this section lists the
 minibuffer window alongside the actual window tree.
@@ -282,7 +284,7 @@ these live windows become leaf nodes of the window tree, as 
@dfn{child
 windows} of a single internal window.  If necessary, Emacs automatically
 creates this internal window, which is also called the @dfn{parent
 window}, and assigns it to the appropriate position in the window tree.
-A set of windows that share the same parent are called @dfn{siblings}.
+The set of windows that share the same parent are called @dfn{siblings}.
 
 @cindex parent window
 @defun window-parent &optional window
@@ -513,7 +515,7 @@ The following function explicitly selects a window and its 
frame.
 
 @defun select-window window &optional norecord
 This function makes @var{window} the selected window and the window
-selected within its frame and selects that frame.  It also makes
+selected within its frame, and selects that frame.  It also makes
 @var{window}'s buffer (@pxref{Buffers and Windows}) current and sets
 that buffer's value of @code{point} to the value of @code{window-point}
 (@pxref{Window Point}) in @var{window}.  @var{window} must be a live
@@ -529,7 +531,7 @@ update the display of @var{window} when its frame gets 
redisplayed the
 next time.  If @var{norecord} is non-@code{nil}, such updates are
 usually not performed.  If, however, @var{norecord} equals the special
 symbol @code{mark-for-redisplay}, the additional actions mentioned above
-are omitted but @var{window} will be nevertheless updated.
+are omitted but @var{window}'s display will be nevertheless updated.
 
 Note that sometimes selecting a window is not enough to show it, or
 make its frame the top-most frame on display: you may also need to
@@ -670,7 +672,7 @@ display a bigger portion of the buffer than one window 
could alone.
 It is often useful to consider such a @dfn{window group} as a single
 entity.  Several functions such as @code{window-group-start}
 (@pxref{Window Start and End}) allow you to do this by supplying, as
-an argument, one of the windows as a stand in for the whole group.
+an argument, one of the windows as a stand-in for the whole group.
 
 @defun selected-window-group
 @vindex selected-window-group-function
diff --git a/lisp/tab-bar.el b/lisp/tab-bar.el
index 82ec617..3dc95c9 100644
--- a/lisp/tab-bar.el
+++ b/lisp/tab-bar.el
@@ -705,11 +705,14 @@ the formatted tab name to display in the tab bar."
   "Template for displaying tab bar items.
 Every item in the list is a function that returns
 a string, or a list of menu-item elements, or nil.
-When you add more items `tab-bar-format-align-right' and
-`tab-bar-format-global' to the end, then after enabling
-`display-time-mode' (or any other mode that uses `global-mode-string')
-it will display time aligned to the right on the tab bar instead of
-the mode line.  Replacing `tab-bar-format-tabs' with
+Adding a function to the list causes the tab bar to show
+that string, or display a menu with those menu items when
+you click on the tab bar.
+If the list ends with `tab-bar-format-align-right' and
+`tab-bar-format-global', then after enabling `display-time-mode'
+(or any other mode that uses `global-mode-string'),
+it will display time aligned to the right on the tab bar instead
+of the mode line.  Replacing `tab-bar-format-tabs' with
 `tab-bar-format-tabs-groups' will group tabs on the tab bar."
   :type 'hook
   :options '(tab-bar-format-menu-global
@@ -728,7 +731,7 @@ the mode line.  Replacing `tab-bar-format-tabs' with
   :version "28.1")
 
 (defun tab-bar-format-menu-global ()
-  "Show global menu on clicking the Menu button."
+  "Produce the Menu button for the tab bar that shows a global menu."
   `((add-tab menu-item (propertize "Menu" 'face 'tab-bar-tab-inactive)
              (lambda (event) (interactive "e")
                (let ((menu (make-sparse-keymap
@@ -745,7 +748,8 @@ the mode line.  Replacing `tab-bar-format-tabs' with
              :help "Global Menu")))
 
 (defun tab-bar-format-history ()
-  "Show back and forward buttons when `tab-bar-history-mode' is enabled.
+  "Produce back and forward buttons for the tab bar.
+These buttons will be shown when `tab-bar-history-mode' is enabled.
 You can hide these buttons by customizing `tab-bar-format' and removing
 `tab-bar-format-history' from it."
   (when tab-bar-history-mode
@@ -781,7 +785,7 @@ You can hide these buttons by customizing `tab-bar-format' 
and removing
         ,(alist-get 'close-binding tab))))))
 
 (defun tab-bar-format-tabs ()
-  "Show all tabs."
+  "Produce all the tabs for the tab bar."
   (let ((i 0))
     (mapcan
      (lambda (tab)
@@ -855,7 +859,7 @@ when the tab is current.  Return the result as a keymap."
       :help "Click to visit group"))))
 
 (defun tab-bar-format-tabs-groups ()
-  "Show tabs with their groups."
+  "Produce tabs for the tab bar grouped according to their groups."
   (let* ((tabs (funcall tab-bar-tabs-function))
          (current-group (funcall tab-bar-tab-group-function
                                  (tab-bar--current-tab-find tabs)))
@@ -899,7 +903,7 @@ when the tab is current.  Return the result as a keymap."
     `((align-right menu-item ,str ignore))))
 
 (defun tab-bar-format-global ()
-  "Format `global-mode-string' to display it in the tab bar.
+  "Produce display of `global-mode-string' in the tab bar.
 When `tab-bar-format-global' is added to `tab-bar-format'
 (possibly appended after `tab-bar-format-align-right'),
 then modes that display information on the mode line