branch master updated: * doc/texinfo.texi (Raise/lower sections): Discuss effect on menus in a single paragraph and move test elsewhere.

[Gavin D. Smith]

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 bb41f2ebd9 * doc/texinfo.texi (Raise/lower sections): Discuss effect 
on menus in a single paragraph and move test elsewhere.
bb41f2ebd9 is described below

commit bb41f2ebd93038aceb95c47f254d39d8f2fb82bb
Author: Gavin Smith <gavinsmith0123@gmail.com>
AuthorDate: Mon Oct 17 20:23:38 2022 +0100

    * doc/texinfo.texi (Raise/lower sections): Discuss effect
    on menus in a single paragraph and move test elsewhere.
---
 ChangeLog        |  7 ++++++-
 doc/texinfo.texi | 13 +++++++------
 2 files changed, 13 insertions(+), 7 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 2b28d77ddd..7a8c21c788 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,6 +1,11 @@
 2022-10-17  Gavin Smith  <gavinsmith0123@gmail.com>
 
-       * doc/texinfo.texi: Remove text with convention for GNU
+       * doc/texinfo.texi (Raise/lower sections): Discuss effect
+       on menus in a single paragraph and move test elsewhere.
+
+2022-10-17  Gavin Smith  <gavinsmith0123@gmail.com>
+
+       * doc/texinfo.texi (@key): Remove text with convention for GNU
        manuals as that doesn't belong here, but rather in a GNU
        standards document.
 
diff --git a/doc/texinfo.texi b/doc/texinfo.texi
index 5a22b6f087..c5ce66e812 100644
--- a/doc/texinfo.texi
+++ b/doc/texinfo.texi
@@ -4203,6 +4203,8 @@ to subsections, and so on.  Thus, a 
@code{@@lowersections} command
 cancels a @code{@@raisesections} command, and vice versa.
 
 @cindex Include files, and section levels
+As a practical matter, you generally only want to raise or lower large
+chunks, usually in external files.
 You can use @code{@@lowersections} to include text written as an outer
 or standalone Texinfo file in another Texinfo file as an inner,
 included file (@pxref{Include Files}).  Typical usage looks like this:
@@ -4220,12 +4222,11 @@ If the included file being lowered has a @code{@@top} 
node, you'll
 need to conditionalize its inclusion with a flag (@pxref{@code{@@set
 @@value}}).
 
-As a practical matter, you generally only want to raise or lower large chunks,
-usually in external files as shown above.  If your document does not rely on
-automatic menus, the final result has to have menus that take the raising
-and lowering into account, so you cannot just arbitrarily sprinkle
-@code{@@raisesections} and @code{@@lowersections} commands throughout
-the document.
+Any menus in the final result have to take the raising and lowering
+into account, so arbitrarily sprinkling @code{@@raisesections} and
+@code{@@lowersections} commands throughout the document will likely
+lead to errors (unless the menus in your document are all generated
+automatically).
 
 Repeated use of the commands continues to raise or lower the
 hierarchical level a step at a time.  An attempt to raise above