From: Eli Zaretskii <eliz@gnu.org>
Date: Fri, 10 Jan 2025 15:03:16 +0000 (+0200)
Subject: ; Fix recently added documentation
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=86b7863587408deac7470642ca7aeeda60767dbd;p=emacs.git

; Fix recently added documentation

* doc/lispref/windows.texi (Splitting Windows): Fix punctuation.
(Resurrecting Windows): Fix typo.
* doc/lispref/elisp.texi (Top): Add the new node to @detailmenu.

(cherry picked from commit 4a8c885dfab87e85edd0897725a242a48f88436b)
---

diff --git a/doc/lispref/elisp.texi b/doc/lispref/elisp.texi
index cc5762e37e5..adec6d847ea 100644
--- a/doc/lispref/elisp.texi
+++ b/doc/lispref/elisp.texi
@@ -1075,6 +1075,7 @@ Windows
 * Deleting Windows::        Deleting a window gives its space to other windows.
 * Recombining Windows::     Preserving the frame layout when splitting and
                               deleting windows.
+* Resurrecting Windows::    Restoring deleted windows.
 * Cyclic Window Ordering::  Moving around the existing windows.
 * Buffers and Windows::     Each window displays the contents of a buffer.
 * Switching Buffers::       Higher-level functions for switching to a buffer.
diff --git a/doc/lispref/windows.texi b/doc/lispref/windows.texi
index 10254db2068..cb406c4e670 100644
--- a/doc/lispref/windows.texi
+++ b/doc/lispref/windows.texi
@@ -1427,7 +1427,7 @@ window.  If non-@code{nil}, @var{refer} can be either a window or a cons
 cell of two windows.
 
 If @var{refer} is a cons cell, its @sc{car} has to specify a deleted,
-former live window - a window that has shown a buffer before - on the
+former live window -- a window that has shown a buffer before -- on the
 same frame as @var{window}.  That buffer must be still live.  The
 @sc{cdr} has to specify a deleted window that was, before its deletion,
 a parent window on the same frame as @var{window}.  In this case, rather
@@ -1439,10 +1439,10 @@ immediately before @var{refer}'s @sc{car} was deleted the last time.
 Decorations and parameters remain unaltered from their values before
 @var{refer}'s @sc{car} and @sc{cdr} were deleted.
 
-Alternatively, @var{refer} may specify a deleted, former live window - a
-window that has shown a buffer before - on the same frame as
+Alternatively, @var{refer} may specify a deleted, former live window -- a
+window that has shown a buffer before -- on the same frame as
 @var{window}.  That buffer must be still live.  In this case, this
-function do not make a new window but rather makes @var{refer} live
+function does not make a new window but rather makes @var{refer} live
 again and inserts it into the window tree at the position and with the
 sizes the new window would have been given.  Buffer, start and point
 positions of @var{refer} are set to the values they had immediately
@@ -2108,7 +2108,8 @@ After a window has been deleted (@pxref{Deleting Windows}) it cannot be
 used any more by functions that require a valid window as their argument
 even if some Lisp variable still references that window.  When the last
 reference to a window has ceased to exist, the window's Lisp object will
-be eventually recycled by the garbage collector.
+be eventually recycled by the garbage collector (@pxref{Garbage
+Collection}).
 
 There are two ways to resurrect a deleted window whose object has not
 been yet recycled by the collector: The first is to keep a reference to
@@ -2189,7 +2190,7 @@ returned by @code{window-prev-sibling} and @code{window-next-sibling} of
 the window and its sibling.
 
 The following code passes both, the new window on the right and its
-parent, via the @var{refer} argument to @code{split-window}: instead.
+parent, via the @var{refer} argument to @code{split-window} instead.
 
 @example
 @group