[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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- branch master updated: * doc/texinfo.texi (The Top Node, Updating Commands): Avoid saying "sectioning command line" as this is confusing.,
Gavin D. Smith <=