[no subject]

[Gavin D. Smith]

branch: master
commit 3efa01a8f52c849bf4074fd543cc6655ccb8610f
Author: Gavin Smith <gavinsmith0123@gmail.com>
AuthorDate: Wed Aug 2 18:01:17 2023 +0100

    * doc/texinfo.texi (Printing): Remove node, as it is duplicative
    of "Texinfo Mode Printing".  Move a paragraph into "Hardcopy with TeX".
---
 ChangeLog        |   5 +++
 doc/texinfo.texi | 111 ++++++++++++++++++++-----------------------------------
 2 files changed, 45 insertions(+), 71 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index b7e044a8df..611a5a6808 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2023-08-02  Gavin Smith <gavinsmith0123@gmail.com>
+
+       * doc/texinfo.texi (Printing): Remove node, as it is duplicative
+       of "Texinfo Mode Printing".  Move a paragraph into "Hardcopy with TeX".
+
 2023-08-02  Gavin Smith <gavinsmith0123@gmail.com>
 
        * doc/texinfo.texi (Emacs Shell Printing): Remove node, moving
diff --git a/doc/texinfo.texi b/doc/texinfo.texi
index 81baf78efc..d0d920c9f5 100644
--- a/doc/texinfo.texi
+++ b/doc/texinfo.texi
@@ -615,7 +615,6 @@ Using Texinfo Mode
 * Showing the Structure::       How to show the structure of a file.
 * Updating Nodes and Menus::    How to update or create new nodes and menus.
 * Info Formatting::             How to format for Info.
-* Printing::                    How to format and print part or all of a file.
 * Printing with Emacs::         How to format with @TeX{} and print with Emacs.
 * Texinfo Mode Summary::        Summary of all the Texinfo mode commands.
 * Formatting Info files::       Processing directly Info files.
@@ -14495,6 +14494,7 @@ Texinfo files.
 @node Hardcopy with @TeX{}
 @chapter Formatting and Printing with @TeX{}
 @anchor{Hardcopy} @c old name
+@anchor{Printing}
 @cindex Format and print hardcopy
 @cindex Printing hardcopy
 @cindex Hardcopy, printing it
@@ -14507,6 +14507,15 @@ Running the @command{texi2dvi} or @command{texi2pdf} 
command is the
 simplest way to create printable output.  These commands are installed
 as part of the Texinfo package.
 
+Typesetting and printing a Texinfo file is a multi-step process in
+which you first create a file for printing (called a DVI file), and
+then print the file.  Optionally, you may also create indices.  To do
+this, you must run the @command{texindex} command after first running the
+@command{tex} typesetting command; and then you must run the
+@command{tex} command again.  Or else run the @command{texi2dvi}
+command which automatically creates indices as needed (@pxref{Format
+with @command{texi2dvi}}).
+
 In more detail, three major shell commands are used to print formatted
 output from a Texinfo manual: one converts the Texinfo source into
 something printable, a second sorts indices, and a third actually
@@ -22081,72 +22090,6 @@ A peculiarity of the @code{texinfo-format-buffer} and
 fill) paragraphs that contain @code{@@w} or @code{@@*} commands.
 
 
-@node Printing
-@section Printing
-@nodedescription How to format and print part or all of a file.
-@cindex Formatting for printing
-@cindex Printing a region or buffer
-@cindex Region formatting and printing
-@cindex Buffer formatting and printing
-@cindex Part of file formatting and printing
-
-Typesetting and printing a Texinfo file is a multi-step process in
-which you first create a file for printing (called a DVI file), and
-then print the file.  Optionally, you may also create indices.  To do
-this, you must run the @command{texindex} command after first running the
-@command{tex} typesetting command; and then you must run the
-@command{tex} command again.  Or else run the @command{texi2dvi}
-command which automatically creates indices as needed (@pxref{Format
-with @command{texi2dvi}}).
-
-Often, when you are writing a document, you want to typeset and print
-only part of a file to see what it will look like.  You can use the
-@code{texinfo-tex-region} and related commands for this purpose.  Use
-the @code{texinfo-tex-buffer} command to format all of a
-buffer.
-
-@table @kbd
-@findex texinfo-tex-buffer
-@item  C-c C-t C-b
-@itemx M-x texinfo-tex-buffer
-Run @command{texi2dvi} on the buffer.  In addition to running @TeX{} on the
-buffer, this command automatically creates or updates indices as
-needed.
-
-@findex texinfo-tex-region
-@item  C-c C-t C-r
-@itemx M-x texinfo-tex-region
-Run @TeX{} on the region.
-
-@item C-c C-t C-i
-@itemx M-x texinfo-texindex
-Run @command{texindex} to sort the indices of a Texinfo file formatted with
-@code{texinfo-tex-region}.  The @code{texinfo-tex-region} command does
-not run @command{texindex} automatically; it only runs the @command{tex}
-typesetting command.  You must run the @code{texinfo-tex-region} command
-a second time after sorting the raw index files with the @command{texindex}
-command.  (Usually, you do not format an index when you format a region,
-only when you format a buffer.  Now that the @command{texi2dvi} command
-exists, there is little or no need for this command.)
-
-@findex texinfo-tex-print
-@item C-c C-t C-p
-@itemx M-x texinfo-tex-print
-Print the file (or the part of the file) previously formatted with
-@code{texinfo-tex-buffer} or @code{texinfo-tex-region}.
-@end table
-
-For @code{texinfo-tex-region} or @code{texinfo-tex-buffer} to work, the
-file @emph{must} start with a @samp{\input texinfo} line and must
-include a @code{@@settitle} line.  The file must end with @code{@@bye}
-on a line by itself.  (When you use @code{texinfo-tex-region}, you must
-surround the @code{@@settitle} line with start-of-header and
-end-of-header lines.)
-
-See the next section for a description of the other @TeX{}-related
-commands, such as @code{tex-show-print-queue}.
-
-
 @node Printing with Emacs
 @nodedescription How to format with @TeX{} and print with Emacs.
 @section Formatting and Printing with Emacs
@@ -22157,7 +22100,7 @@ key commands for formatting and printing.
 
 
 @node Texinfo Mode Printing
-@nodedescription How to format and print in Texinfo mode.
+@nodedescription How to format and print part or all of a file.
 @subsection Formatting and Printing in Texinfo Mode
 @cindex Region printing in Texinfo mode
 @cindex Format and print in Texinfo mode
@@ -22169,10 +22112,30 @@ looking at the printer queue, killing the formatting 
job, and
 recentering the display of the buffer in which the operations
 occur.
 
+@cindex Printing a region or buffer
+@cindex Region formatting and printing
+@cindex Buffer formatting and printing
+@cindex Part of file formatting and printing
+Often, when you are writing a document, you want to typeset and print
+only part of a file to see what it will look like.  You can use the
+@code{texinfo-tex-region} and related commands for this purpose.  Use
+the @code{texinfo-tex-buffer} command to format all of a
+buffer.
+
+For @code{texinfo-tex-region} or @code{texinfo-tex-buffer} to work, the
+file @emph{must} start with a @samp{\input texinfo} line and must
+include a @code{@@settitle} line.  The file must end with @code{@@bye}
+on a line by itself.  (When you use @code{texinfo-tex-region}, you must
+surround the @code{@@settitle} line with start-of-header and
+end-of-header lines.)
+
 @table @kbd
+@findex texinfo-tex-buffer
 @item C-c C-t C-b
 @itemx M-x texinfo-tex-buffer
-Run @command{texi2dvi} on the current buffer.
+Run @command{texi2dvi} on the buffer.  In addition to running @TeX{} on the
+buffer, this command automatically creates or updates indices as
+needed.
 
 @item C-c C-t C-r
 @itemx M-x texinfo-tex-region
@@ -22187,8 +22150,14 @@ will format the region in ``small'' book size.
 
 @item C-c C-t C-i
 @itemx M-x texinfo-texindex
-Sort the indices of a Texinfo file formatted with
-@code{texinfo-tex-region}.
+Run @command{texindex} to sort the indices of a Texinfo file formatted with
+@code{texinfo-tex-region}.  The @code{texinfo-tex-region} command does
+not run @command{texindex} automatically; it only runs the @command{tex}
+typesetting command.  You must run the @code{texinfo-tex-region} command
+a second time after sorting the raw index files with the @command{texindex}
+command.  (Usually, you do not format an index when you format a region,
+only when you format a buffer.  Now that the @command{texi2dvi} command
+exists, there is little or no need for this command.)
 
 @item C-c C-t C-p
 @itemx M-x texinfo-tex-print