texinfo-commits
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

branch master updated: * doc/texinfo.texi (The Top Node, Updating Comman


From: Gavin D. Smith
Subject: branch master updated: * doc/texinfo.texi (The Top Node, Updating Commands): Avoid saying "sectioning command line" as this is confusing.
Date: Sun, 02 Jun 2024 17:27:29 -0400

This is an automated email from the git hooks/post-receive script.

gavin pushed a commit to branch master
in repository texinfo.

The following commit(s) were added to refs/heads/master by this push:
     new c5cfa15323 * doc/texinfo.texi (The Top Node, Updating Commands): Avoid 
saying "sectioning command line" as this is confusing.
c5cfa15323 is described below

commit c5cfa15323aea6f9978be6e4918e288696b4d1bc
Author: Gavin Smith <gavinsmith0123@gmail.com>
AuthorDate: Sun Jun 2 22:27:19 2024 +0100

    * doc/texinfo.texi (The Top Node, Updating Commands):
    Avoid saying "sectioning command line" as this is confusing.
---
 ChangeLog        |  5 +++++
 doc/texinfo.texi | 14 ++++++--------
 2 files changed, 11 insertions(+), 8 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 5aad7bec47..2490e88517 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2024-06-02  Gavin Smith <gavinsmith0123@gmail.com>
+
+       * doc/texinfo.texi (The Top Node, Updating Commands):
+       Avoid saying "sectioning command line" as this is confusing.
+
 2024-06-02  Gavin Smith <gavinsmith0123@gmail.com>
 
        Prepare for pretest release
diff --git a/doc/texinfo.texi b/doc/texinfo.texi
index f19c08a72d..8c57153157 100644
--- a/doc/texinfo.texi
+++ b/doc/texinfo.texi
@@ -1958,8 +1958,8 @@ As such, it should contain a very brief description of 
the manual
 (including the version number).  The contents of the `Top' node do
 not appear in printed output nor in DocBook output.
 
-It is conventional to write a @code{@@top} sectioning command
-line containing the title of the document immediately after the
+It is conventional to write a line with a @code{@@top} command
+containing the title of the document immediately after the
 @code{@@node Top} line (@pxref{@code{@@top} Command}).
 
 We repeat the short description from the beginning of
@@ -21772,13 +21772,11 @@ You can also use the commands to update all the nodes 
and menus in a
 region or in a whole Texinfo file.
 
 The updating commands work only with conventional Texinfo files, which
-are structured hierarchically like books.  In such files, a structuring
-command line must follow closely after each @code{@@node} line, except
-for the `Top' @code{@@node} line.  (A @dfn{structuring command line} is
-a line beginning with @code{@@chapter}, @code{@@section}, or other
-similar command.)
+are structured hierarchically like books.  In such files, a line with a
+structuring command must follow closely after each @code{@@node} line,
+except for the `Top' @code{@@node} line.
 
-You can write the structuring command line on the line that follows
+You can write the structuring command on the line that follows
 immediately after an @code{@@node} line or else on the line that
 follows after a single @code{@@comment} line or a single
 @code{@@ifinfo} line.  You cannot interpose more than one line between



reply via email to

[Prev in Thread] Current Thread [Next in Thread]