branch master updated: * doc/texinfo.texi (@xref): Raise level of subsections and move remainder of section before the sections for the other ref commands.

[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 3da82743cf * doc/texinfo.texi (@xref): Raise level of subsections and 
move remainder of section before the sections for the other ref commands.
3da82743cf is described below

commit 3da82743cf372e4191970e723619c81d8c60ff2d
Author: Gavin Smith <gavinsmith0123@gmail.com>
AuthorDate: Tue Aug 16 11:33:19 2022 +0100

    * doc/texinfo.texi (@xref): Raise level of subsections and
    move remainder of section before the sections for the other
    ref commands.
---
 ChangeLog        |  6 ++++++
 doc/texinfo.texi | 60 +++++++++++++++++++++++++++-----------------------------
 2 files changed, 35 insertions(+), 31 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 8a17d52a84..842797cf31 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2022-08-16  Gavin Smith  <gavinsmith0123@gmail.com>
+
+       * doc/texinfo.texi (@xref): Raise level of subsections and
+       move remainder of section before the sections for the other
+       ref commands.
+
 2022-08-16  Gavin Smith  <gavinsmith0123@gmail.com>
 
        Correct quoting of nodename with manual part
diff --git a/doc/texinfo.texi b/doc/texinfo.texi
index e7690b6e2b..67deed9d13 100644
--- a/doc/texinfo.texi
+++ b/doc/texinfo.texi
@@ -243,8 +243,12 @@ Cross-references
 * References::                  What cross-references are for.
 * Cross Reference Commands::    A summary of the different commands.
 * Cross Reference Parts::       A cross-reference has several parts.
-* @code{@@xref}::                       Begin a reference with `See' @dots{}
+* One Argument::                @code{@@xref} with one argument.
+* Two Arguments::               @code{@@xref} with two arguments.
+* Three Arguments::             @code{@@xref} with three arguments.
+* Four and Five Arguments::     @code{@@xref} with four and five arguments.
 * Referring to a Manual as a Whole::   Refer to an entire manual.
+* @code{@@xref}::                       Begin a reference with `See' @dots{}
 * @code{@@ref}::                        A reference for the last part of a 
sentence.
 * @code{@@pxref}::                      How to write a parenthetical 
cross-reference.
 * @code{@@anchor}::                     Defining arbitrary cross-reference 
targets
@@ -252,13 +256,6 @@ Cross-references
 * @code{@@url}::                        How to refer to a uniform resource 
locator.
 * @code{@@cite}::                       How to refer to books not in the Info 
system.
 
-@code{@@xref}
-
-* One Argument::                @code{@@xref} with one argument.
-* Two Arguments::               @code{@@xref} with two arguments.
-* Three Arguments::             @code{@@xref} with three arguments.
-* Four and Five Arguments::     @code{@@xref} with four and five arguments.
-
 @code{@@url}, @code{@@uref@{@var{url}[, @var{text}][, @var{replacement}]@}}
 
 * @code{@@url} Examples::           Examples of using all the forms of 
@code{@@url}.
@@ -4281,8 +4278,12 @@ same or different Texinfo files.
 * References::                  What cross-references are for.
 * Cross Reference Commands::    A summary of the different commands.
 * Cross Reference Parts::       A cross-reference has several parts.
-* @code{@@xref}::                       Begin a reference with `See' @dots{}
+* One Argument::                @code{@@xref} with one argument.
+* Two Arguments::               @code{@@xref} with two arguments.
+* Three Arguments::             @code{@@xref} with three arguments.
+* Four and Five Arguments::     @code{@@xref} with four and five arguments.
 * Referring to a Manual as a Whole::   Refer to an entire manual.
+* @code{@@xref}::                       Begin a reference with `See' @dots{}
 * @code{@@ref}::                        A reference for the last part of a 
sentence.
 * @code{@@pxref}::                      How to write a parenthetical 
cross-reference.
 * @code{@@anchor}::                     Defining arbitrary cross-reference 
targets
@@ -4423,6 +4424,9 @@ Whitespace before and after the commas separating these 
arguments is
 ignored.  To include a comma in one of the arguments, use
 @code{@@comma@{@}} (@pxref{Inserting a Comma}).
 
+Cross-references with one, two, three, four, and five arguments are
+described separately in this chapter.
+
 @cindex Comma after cross-reference
 When processing with TeX, a comma is automatically inserted after the
 page number for cross-references to within the same manual, unless the
@@ -4451,9 +4455,6 @@ See Hurricanes, page @var{ppp} --- for the details
 @noindent instead of
 @w{`See Hurricanes, page @var{ppp}, --- for the details'}.
 
-Cross-references with one, two, three, four, and five arguments are
-described separately following the description of @code{@@xref}.
-
 @command{makeinfo} warns when the text of a cross-reference (and node
 names and menu items) contains a problematic construct that will
 interfere with its parsing in Info.  If you don't want to see the
@@ -4462,25 +4463,7 @@ warnings, you can set the customization variable
 Customization Variables}).
 
 
-@node @code{@@xref}
-@section @code{@@xref}
-
-@anchor{xref}@c old name
-@findex xref
-@cindex Cross-references using @code{@@xref}
-@cindex References using @code{@@xref}
-
-The @code{@@xref} command generates a cross-reference for the
-beginning of a sentence.
-
-@menu
-* One Argument::                @code{@@xref} with one argument.
-* Two Arguments::               @code{@@xref} with two arguments.
-* Three Arguments::             @code{@@xref} with three arguments.
-* Four and Five Arguments::     @code{@@xref} with four and five arguments.
-@end menu
-
-
+@raisesections
 @node One Argument
 @subsection @code{@@xref} with One Argument
 @cindex One-argument form of cross-references
@@ -4782,6 +4765,8 @@ Finally, it's also allowed to leave out all the arguments
 @emph{except} the fourth and fifth, to refer to another manual as a
 whole.  See the next section.
 
+@lowersections
+
 
 @node Referring to a Manual as a Whole
 @section Referring to a Manual as a Whole
@@ -4856,6 +4841,19 @@ arbitrariness of the first name is a principal reason 
why omitting the
 third argument in whole-manual cross-references is preferable.
 
 
+@node @code{@@xref}
+@section @code{@@xref}
+
+@anchor{xref}@c old name
+@findex xref
+@cindex Cross-references using @code{@@xref}
+@cindex References using @code{@@xref}
+
+The @code{@@xref} command generates a cross-reference for the
+beginning of a sentence.  Examples of using @code{@@xref} are
+in previous sections.
+
+
 @node @code{@@ref}
 @section @code{@@ref}