[no subject]

[Gavin D. Smith]

branch: master
commit ef892f795188227f04be051b8a5838bd20b69b8d
Author: Gavin Smith <gavinsmith0123@gmail.com>
AuthorDate: Thu Aug 3 18:56:09 2023 +0100

    * doc/texinfo.texi: Finish removing most @menu blocks, using
    @nodedescription instead.
---
 ChangeLog        |  5 +++++
 doc/texinfo.texi | 47 ++++++++++++-----------------------------------
 2 files changed, 17 insertions(+), 35 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index f2b46922e4..0372aa8429 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2023-08-03  Gavin Smith <gavinsmith0123@gmail.com>
+
+       * doc/texinfo.texi: Finish removing most @menu blocks, using
+       @nodedescription instead.
+
 2023-08-02  Gavin Smith <gavinsmith0123@gmail.com>
 
        * tp/Texinfo/Convert/Plaintext.pm (_convert) <node description>:
diff --git a/doc/texinfo.texi b/doc/texinfo.texi
index 9bd890dd67..add9457c25 100644
--- a/doc/texinfo.texi
+++ b/doc/texinfo.texi
@@ -14158,12 +14158,6 @@ the line number should refer to the original source 
file, whatever it
 may be.  There's a well-known mechanism for this: the so-called
 @samp{#line} directive.  Texinfo supports this.
 
-@menu
-* @samp{#line} Directive::
-* TeX: @samp{#line} and @TeX{}.
-* Syntax: @samp{#line} Syntax Details.
-@end menu
-
 
 @node @samp{#line} Directive
 @subsection @samp{#line} Directive
@@ -15136,18 +15130,9 @@ Initialization files are written in Perl, like the 
main program, and
 anything which can be specified on the command line can also be
 specified within a initialization file.
 
-@menu
-* Invoking @command{texi2any}::           Running the translator from a shell.
-* @command{texi2any} Environment Variables::
-* @command{texi2any} Printed Output::     Calling @command{texi2dvi}.
-* Customization Variables::     Configuring @command{texi2any}.
-* Internationalization of Document Strings:: Translating program-inserted text.
-* Invoking @command{pod2texi}::           Translating Perl Pod to Texinfo.
-* @command{texi2html}::                   An ancestor of @command{texi2any}.
-@end menu
-
 
 @node Invoking @command{texi2any}
+@nodedescription Running the translator from a shell.
 @section Invoking @command{texi2any} from a Shell
 
 @anchor{Invoking makeinfo}
@@ -15724,6 +15709,7 @@ Generate Texinfo XML output (rather than Info).
 
 
 @node @command{texi2any} Environment Variables
+@nodedescription Control over output format and XS use.
 @section Environment Variables Recognized by @command{texi2any}
 
 @cindex Environment variable @code{TEXINFO_OUTPUT_FORMAT}
@@ -15787,6 +15773,7 @@ native code implementation and the implementation in 
pure Perl code.
 
 
 @node @command{texi2any} Printed Output
+@nodedescription Calling @command{texi2dvi}.
 @section @command{texi2any} Printed Output
 
 @cindex Printed output, through @command{texi2any}
@@ -15843,6 +15830,7 @@ invokes @command{texi2dvi}, only diagnostic messages.
 
 
 @node Customization Variables
+@nodedescription Configuring @command{texi2any}.
 @section Customization Variables
 
 @quotation Warning
@@ -17077,6 +17065,7 @@ transliterate more characters; default true.
 
 
 @node Internationalization of Document Strings
+@nodedescription Translating program-inserted text.
 @section Internationalization of Document Strings
 
 @cindex I18n, of document strings
@@ -17188,6 +17177,7 @@ appropriately in many languages.
 
 
 @node Invoking @command{pod2texi}
+@nodedescription Translating Perl Pod to Texinfo.
 @section Invoking @command{pod2texi}: Convert Pod to Texinfo
 
 @pindex pod2texi
@@ -17223,16 +17213,14 @@ included below.  The version included in the manual 
is also an example of
 @c Perl documentation itself, see @file{contrib/perldoc-all}} in the Texinfo
 @c source distribution.
 
-@menu
-* pod2texi manual page::      @command{pod2texi} invocation in a manual page 
format.
-@end menu
-
 
 @node pod2texi manual page
+@nodedescription @command{pod2texi} invocation in a manual page format.
 @include pod2texi.texi
 
 
 @node @command{texi2html}
+@nodedescription An ancestor of @command{texi2any}.
 @section @command{texi2html}: Ancestor of @command{texi2any}
 
 @pindex texi2html
@@ -17330,13 +17318,6 @@ Formatting}.  @xref{Info Files}, for general 
information about the file format.
 @xref{Info Format Specification}, for a detailed technical specification of the
 Info format.
 
-@menu
-* Installing an Info File::
-* Tag and Split Files::         How tagged and split files help Info
-                                 to run better.
-* Info Format FAQ::
-@end menu
-
 
 @node Installing an Info File
 @section Installing an Info File
@@ -18441,7 +18422,7 @@ The algorithm was primarily devised by Patrice Dumas in 
2003--04.
 * Command Expansion: HTML Xref Command Expansion.
 * 8-bit Expansion:   HTML Xref 8-bit Character Expansion.
 * Mismatch:          HTML Xref Mismatch.
-* Configuration:     HTML Xref Configuration. @file{htmlxref.cnf}.
+* Configuration:     HTML Xref Configuration.
 @end menu
 
 
@@ -18809,6 +18790,7 @@ control.
 
 
 @node HTML Xref Configuration
+@nodedescription @file{htmlxref.cnf}.
 @subsection HTML Cross-reference Configuration: @file{htmlxref.cnf}
 
 @pindex htmlxref.cnf
@@ -20820,12 +20802,6 @@ Write notes for yourself at the very end of a Texinfo 
file after the
 
 This appendix includes texts to be used in GNU manuals.
 
-@menu
-* GNU Sample Texts::
-* Verbatim Copying License::
-* All-permissive Copying License::
-@end menu
-
 
 @node GNU Sample Texts
 @section GNU Sample Texts
@@ -23784,7 +23760,7 @@ back to other parts of this manual for examples and 
definitions,
 rather than redundantly spelling out every detail.
 
 @menu
-* Whole:           Info Format Whole Manual. Split vs.@: nonsplit manuals.
+* Whole:           Info Format Whole Manual.
 * Preamble:        Info Format Preamble.
 * Indirect:        Info Format Indirect Table.
 * Tag table:       Info Format Tag Table.
@@ -23798,6 +23774,7 @@ rather than redundantly spelling out every detail.
 
 
 @node Info Format Whole Manual
+@nodedescription Split vs.@: nonsplit manuals.
 @section Info Format: A Whole Manual
 
 @cindex Nonsplit manuals, Info format of