branch master updated: doc/texinfo.texi: two empty lines before @noodes. Change in comments

[Patrice Dumas]

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

pertusus pushed a commit to branch master
in repository texinfo.

The following commit(s) were added to refs/heads/master by this push:
     new 24b3b3ea07 doc/texinfo.texi: two empty lines before @noodes.  Change 
in comments
24b3b3ea07 is described below

commit 24b3b3ea074dedd0d836d27cb44845d22b4455ca
Author: Patrice Dumas <pertusus@free.fr>
AuthorDate: Fri Jul 22 15:43:43 2022 +0200

    doc/texinfo.texi: two empty lines before @noodes.  Change in comments
---
 doc/texinfo.texi          | 53 ++++++++++++++++++++++++-----------------------
 tp/Texinfo/Common.pm      |  2 +-
 tp/Texinfo/ParserNonXS.pm |  2 +-
 3 files changed, 29 insertions(+), 28 deletions(-)

diff --git a/doc/texinfo.texi b/doc/texinfo.texi
index 250a7b740e..bf8993b4d2 100644
--- a/doc/texinfo.texi
+++ b/doc/texinfo.texi
@@ -1105,7 +1105,6 @@ It is GNU software written by Brendan O'Dea, available 
from
 @uref{http://www.gnu.org/software/help2man}.
 
 
-
 @node History
 @section History
 
@@ -1508,7 +1507,6 @@ the minimum, which can be useful for short documents, is 
just the two
 lines at the beginning and the one line at the end.
 
 
-
 @node Short Sample Texinfo File
 @anchor{Short Sample}@c
 @anchor{Sample Beginning}@c
@@ -1672,7 +1670,6 @@ to use Texinfo mode when the file is edited:
 from the file extension automatically.
 
 
-
 @node @code{@@setfilename}
 @subsection @code{@@setfilename}: Set the Output File Name
 
@@ -1787,7 +1784,6 @@ generally appears as a @code{@@subtitle} so it would be 
omitted from the
 @code{@@title}.  @xref{@code{@@titlepage}}.
 
 
-
 @node Preamble
 @subsection Preamble
 @cindex Preamble
@@ -2208,8 +2204,6 @@ page.  In HTML, @code{@@shorttitlepage} can play the same 
role as
 @code{@@settitle}, if @code{@@settitle} is not set.  @xref{@code{@@settitle}}.
 
 
-
-
 @node @code{@@title @@subtitle @@author}
 @subsection @code{@@title}, @code{@@subtitle}, and @code{@@author}
 
@@ -2428,7 +2422,6 @@ You could include other title-like information for the 
plain text
 output in the same place.
 
 
-
 @node Heading Generation
 @subsection Heading Generation
 
@@ -2643,6 +2636,7 @@ Beginning a Texinfo File
 @end group
 @end example
 
+
 @node The Body of the Document
 @section The Body of the Document
 
@@ -2749,8 +2743,6 @@ a line by itself.  Anything following @code{@@bye} is 
completely
 ignored.
 
 
-
-
 @node Nodes
 @chapter Nodes
 @anchor{node}@anchor{@@node} @c old names
@@ -3406,6 +3398,7 @@ first nine entries.  This allows people using web 
browsers to follow
 the first menu entries using (typically) @kbd{M-@var{digit}}, e.g.,
 @kbd{M-1} for the first entry.
 
+
 @node Menu Example
 @subsection A Menu Example
 @cindex Menu example
@@ -3554,7 +3547,6 @@ warnings, you can set the customization variable
 Customization Variables}).
 
 
-
 @node Less Cluttered Menu Entry
 @subsection Less Cluttered Menu Entry
 @cindex Two part menu entry
@@ -4280,6 +4272,8 @@ and not used online, you must nonetheless write 
@code{@@node} lines (or
 cross-references.
 
 @need 800
+
+
 @node Cross Reference Commands
 @section Different Cross-reference Commands
 @cindex Different cross-reference commands
@@ -4480,6 +4474,7 @@ beginning of a sentence.
 * Four and Five Arguments::     @code{@@xref} with four and five arguments.
 @end menu
 
+
 @node One Argument
 @subsection @code{@@xref} with One Argument
 @cindex One-argument form of cross-references
@@ -6773,7 +6768,6 @@ single spaces, and that is not what they look like.
 @end quotation
 
 
-
 @node @code{@@verbatim}
 @section @code{@@verbatim}: Literal Text
 
@@ -7217,6 +7211,7 @@ Info, you'll see the @code{@@cartouche} had no effect):
 
 @code{@@cartouche} also implies @code{@@group} (@pxref{@code{@@group}}).
 
+
 @node small
 @section @code{@@small@dots{}} Block Commands
 
@@ -7272,7 +7267,6 @@ commands (such as @code{@@example} instead of 
@code{@@smallexample}),
 unless you have a good reason for it.
 
 
-
 @node Lists and Tables
 @chapter Lists and Tables
 @cindex Making lists and tables
@@ -7291,6 +7285,7 @@ the first column; multi-column tables are also supported.
 * Multi-column Tables::         How to construct generalized tables.
 @end menu
 
+
 @node Introducing Lists
 @section Introducing Lists
 
@@ -7620,6 +7615,7 @@ explanatory exhibits, and command-line option summaries.
 * @code{@@itemx}::                      How to put more entries in the first 
column.
 @end menu
 
+
 @node @code{@@table}
 @subsection Using the @code{@@table} Command
 
@@ -7706,6 +7702,7 @@ doesn't make sense to use them together.  If you want to 
indent a
 table, try @code{@@quotation} (@pxref{@code{@@quotation}}) or
 @code{@@indentedblock} (@pxref{@code{@@indentedblock}}).
 
+
 @node @code{@@ftable @@vtable}
 @subsection @code{@@ftable} and @code{@@vtable}
 
@@ -7804,6 +7801,7 @@ multitable} completes the table.  Details in the sections 
below.
 * Multitable Rows::             Defining multitable rows, with examples.
 @end menu
 
+
 @node Multitable Column Widths
 @subsection Multitable Column Widths
 @cindex Multitable column widths
@@ -8739,6 +8737,7 @@ txiindexbackslashignore} causes the @samp{\mathopsup} 
entry in the
 index for this manual to be sorted as if it were @samp{mathopsup},
 so that it appears among the other entries beginning with `M'.
 
+
 @node Advanced Indexing
 @section Advanced Indexing Commands
 @cindex Indexing, advanced
@@ -8802,6 +8801,7 @@ commas in the correct places for you.
 These features are the most useful with printed documents, and
 when translating Texinfo to DocBook.
 
+
 @node Index Entries
 @section Making Index Entries
 @cindex Index entries, making
@@ -11530,6 +11530,7 @@ can be used for other programming languages.
 * Abstract Objects::            Commands for object-oriented programming.
 @end menu
 
+
 @node Functions Commands
 @subsection Functions and Similar Entities
 
@@ -14483,8 +14484,6 @@ and you can get it over the Internet or on physical 
media.  See
 @c please keep that text in sync with www.gnu.org/prep/FTP
 
 
-
-
 @node Format with @command{texi2dvi}
 @section Format with @command{texi2dvi}
 
@@ -14880,6 +14879,7 @@ key commands for formatting and printing.
 * Compile-Command::             How to print using Emacs's compile command.
 @end menu
 
+
 @node Emacs Shell Printing
 @subsection Printing From an Emacs Shell
 
@@ -17180,9 +17180,11 @@ included below.  The version included in the manual is 
also an example of
 * pod2texi manual page::      @command{pod2texi} invokation in a manual page 
format
 @end menu
 
+
 @node pod2texi manual page
 @include pod2texi.texi
 
+
 @node @command{texi2html}
 @section @command{texi2html}: Ancestor of @command{texi2any}
 
@@ -17290,8 +17292,6 @@ See also @ref{Generic Translator @command{texi2any}} 
and @ref{Info Formatting}.
 @end menu
 
 
-
-
 @node Installing an Info File
 @section Installing an Info File
 @cindex Installing an Info file
@@ -17367,7 +17367,6 @@ See the @file{util/dir-example} file in the Texinfo 
distribution for
 a large sample @code{dir} file.
 
 
-
 @node New Info File
 @subsection Listing a New Info File
 @cindex Adding a new Info file
@@ -17787,6 +17786,7 @@ Display version information and exit successfully.
 
 @end table
 
+
 @node Tag and Split Files
 @section Tag Files and Split Files
 
@@ -17871,6 +17871,7 @@ information on how to prevent files from being split 
with
 @code{texinfo-format-buffer} and how to validate the structure of the nodes,
 see @ref{Using @code{Info-validate}}.
 
+
 @node Info Format FAQ
 @section Info Format FAQ
 
@@ -17967,8 +17968,6 @@ If you want more, you are recommended to use the HTML 
output from
 @end table
 
 
-
-
 @node Generating HTML
 @chapter Generating HTML
 
@@ -18742,6 +18741,7 @@ distributed with Texinfo, please email 
@email{bug-texinfo@@gnu.org} as
 usual.  You can get the latest version from
 @url{http://ftpmirror.gnu.org/@/texinfo/@/htmlxref.cnf}.
 
+
 @node @code{@@documentdescription}
 @section @code{@@documentdescription}: Summary Text
 @anchor{documentdescription}@c old name
@@ -18780,6 +18780,7 @@ This will produce the following output in the 
@samp{<head>} of the HTML:
 Here are the details of @@-commands: information about their syntax, a 
 list of commands, and information about where commands can appear.
 
+
 @node Command Syntax
 @section @@-Command Syntax
 @cindex @sortas{at} @@-commands @subentry syntax
@@ -20769,7 +20770,6 @@ This manual is for GNU Sample (version @value{VERSION}, 
@value{UPDATED}).
 * Index::
 @end menu
 
-
 @node Invoking sample
 @chapter Invoking sample
 
@@ -20780,13 +20780,11 @@ This is a sample manual.  There is no sample program 
to
 invoke, but if there were, you could see its basic usage
 and command line options here.
 
-
 @node GNU Free Documentation License
 @appendix GNU Free Documentation License
 
 @include fdl.texi
 
-
 @node Index
 @unnumbered Index
 
@@ -20884,6 +20882,7 @@ commands and tools to help ease your work.
 * Batch Formatting::            How to format for Info in Emacs batch mode.
 @end menu
 
+
 @node Texinfo Mode Overview
 @section Texinfo Mode Overview
 
@@ -21897,8 +21896,6 @@ A peculiarity of the @code{texinfo-format-buffer} and
 fill) paragraphs that contain @code{@@w} or @code{@@*} commands.
 
 
-
-
 @node Printing
 @section Printing
 @cindex Formatting for printing
@@ -21963,6 +21960,7 @@ end-of-header lines.)
 @xref{Hardcopy with @TeX{}}, for a description of the other @TeX{} related
 commands, such as @code{tex-show-print-queue}.
 
+
 @node Texinfo Mode Summary
 @section Texinfo Mode Summary
 
@@ -22526,6 +22524,7 @@ on a large file, you must run 
@code{texinfo-format-buffer} with an
 argument so that it does not split the Info file; and you must create a
 tag table for the unsplit file.
 
+
 @node Unsplit
 @subsubsection Creating an Unsplit File
 @cindex Creating an unsplit file
@@ -22564,6 +22563,7 @@ a tag table for it.
 @cindex Making a tag table manually
 @cindex Tag table, making manually
 
+
 @node Tagifying
 @subsubsection Tagifying a File
 
@@ -22601,6 +22601,7 @@ After you have validated the node structure, you can 
rerun
 tag table and split the file automatically, or you can make the tag
 table and split the file manually.
 
+
 @node Splitting
 @section Splitting a File Manually
 @cindex Splitting an Info file manually
@@ -22671,7 +22672,6 @@ you can continue working in it.  (When you run
 use that Emacs for anything else until the command finishes.)
 
 
-
 @node Global Document Commands
 @appendix Global Document Commands
 @cindex Global Document Commands
@@ -22692,6 +22692,7 @@ They are generally all given before the Top node, if 
they are given at all.
 * Magnification::               How to print scaled up output.
 @end menu
 
+
 @node @code{@@setchapternewpage}
 @section @code{@@setchapternewpage}: Blank Pages Before Chapters
 
@@ -22765,7 +22766,6 @@ pages) use the @option{--texinfo} option to 
@command{texi2dvi} to
 specify the output you want.
 
 
-
 @node Headings
 @section Page Headings
 @anchor{Headings Introduced}@c old name
@@ -22806,6 +22806,7 @@ right part is set flushright.
 * Custom Headings::             How to create your own headings and footings.
 @end menu
 
+
 @node @code{@@headings}
 @subsection The @code{@@headings} Command
 
diff --git a/tp/Texinfo/Common.pm b/tp/Texinfo/Common.pm
index 230d792e2a..d7a68abf68 100644
--- a/tp/Texinfo/Common.pm
+++ b/tp/Texinfo/Common.pm
@@ -235,7 +235,7 @@ my %default_main_program_command_line_options = (
 # used in main program, defaults documented in manual
 my %default_main_program_customization = (
   'CHECK_NORMAL_MENU_STRUCTURE' => 0, # output warnings when node with
-            # automatic direction does directions in menu are not consistent
+            # automatic direction and directions in menu are not consistent
             # with sectionning, and when node directions are not consistent
             # with menu directions.
   'DUMP_TREE'                   => undef,
diff --git a/tp/Texinfo/ParserNonXS.pm b/tp/Texinfo/ParserNonXS.pm
index dd60f1eda9..f05d91d3b5 100644
--- a/tp/Texinfo/ParserNonXS.pm
+++ b/tp/Texinfo/ParserNonXS.pm
@@ -2747,7 +2747,7 @@ sub _enter_index_entry($$$$$$$)
 }
 
 # Used for file names and index sort strings to allow including the special
-# Texinfo characters.
+# Texinfo characters but not other command nor element type.
 sub _convert_to_text {
   my $e = shift;