-diff -Nru texinfo-3.12s/doc/texinfo.txi texinfo-3.12s.new/doc/texinfo.txi
---- texinfo-3.12s/doc/texinfo.txi Mon Aug 9 22:43:55 1999
-+++ texinfo-3.12s.new/doc/texinfo.txi Wed Sep 8 22:06:16 1999
-@@ -22,13 +22,13 @@
+--- texinfo-7.1/doc/info-stnd.texi.orig 2023-10-08 13:25:11.000000000 +0200
++++ texinfo-7.1/doc/info-stnd.texi 2023-11-06 17:42:26.673145395 +0100
+@@ -34,9 +34,9 @@ separately from the collection, you can
+ license to the document, as described in section 6 of the license.
+ @end copying
- @comment %**end of header
+-@dircategory Texinfo documentation system
++@dircategory Texinfo documentation system:
+ @direntry
+-* info stand-alone: (info-stnd). Read Info documents without Emacs.
++* info stand-alone: (info-stnd). Read Info documents without Emacs
+ @end direntry
+
+ @titlepage
+--- texinfo-7.1/doc/texinfo.texi.orig 2023-10-18 14:30:47.000000000 +0200
++++ texinfo-7.1/doc/texinfo.texi 2023-11-04 00:25:57.719850317 +0100
+@@ -45,17 +45,17 @@ Texts. A copy of the license is include
+ @end quotation
+ @end copying
-@dircategory Texinfo documentation system
+@dircategory Texinfo documentation system:
@direntry
-* Texinfo: (texinfo). The GNU documentation format.
-* install-info: (texinfo)Invoking install-info. Update info/dir entries.
+-* texi2any: (texinfo)Invoking texi2any. Translate Texinfo source.
+-* makeinfo: (texinfo)Invoking texi2any. Translate Texinfo source.
+-* pod2texi: (pod2texi)Invoking pod2texi. Translate Perl Pod to Texinfo.
-* texi2dvi: (texinfo)Format with texi2dvi. Print Texinfo documents.
+-* texi2pdf: (texinfo)PDF Output. PDF output for Texinfo.
+-* pdftexi2dvi: (texinfo)PDF Output. PDF output for Texinfo.
-* texindex: (texinfo)Format with tex/texindex. Sort Texinfo index files.
--* makeinfo: (texinfo)makeinfo Preferred. Translate Texinfo source.
-+* Texinfo: (texinfo) The GNU documentation format
-+* install-info: (texinfo)install-info Update info/dir entries
-+* texi2dvi: (texinfo)texi2dvi Print Texinfo documents
-+* texindex: (texinfo)texindex Sort Texinfo index files
-+* makeinfo: (texinfo)makeinfo Translate Texinfo source
++* Texinfo: (texinfo). The GNU documentation format
++* install-info: (texinfo)install-info. Update info/dir entries
++* texi2any: (texinfo)texi2any. Translate Texinfo source
++* makeinfo: (texinfo)makeinfo. Translate Texinfo source
++* pod2texi: (texinfo)pod2texi. Translate Perl Pod to Texinfo
++* texi2dvi: (texinfo)texi2dvi. Print Texinfo documents
++* texi2pdf: (texinfo)PDF Output. PDF output for Texinfo
++* pdftexi2dvi: (texinfo)PDF Output. PDF output for Texinfo
++* texindex: (texinfo)tex/texindex. Sort Texinfo index files
@end direntry
- @c Before release, run C-u C-c C-u C-a (texinfo-all-menus-update with a
-@@ -538,8 +538,8 @@
- Formatting and Printing Hardcopy
-
- * Use TeX:: Use @TeX{} to format for hardcopy.
--* Format with tex/texindex:: How to format with explicit shell commands.
--* Format with texi2dvi:: A simpler way to format.
-+* texindex:: How to format with explicit shell commands.
-+* texi2dvi:: A simpler way to format.
- * Print with lpr:: How to print.
- * Within Emacs:: How to format and print from an Emacs shell.
- * Texinfo Mode Printing:: How to format and print in Texinfo mode.
-@@ -582,7 +582,7 @@
- located in other directories.
- * Installing Dir Entries:: How to specify what menu entry to add
- to the Info directory.
--* Invoking install-info:: @code{install-info} options.
-+* install-info:: @code{install-info} options.
-
- Sample Permissions
-
-@@ -610,7 +610,7 @@
-
- Formatting Mistakes
-
--* makeinfo Preferred:: @code{makeinfo} finds errors.
-+* makeinfo:: @code{makeinfo} finds errors.
- * Debugging with Info:: How to catch errors with Info formatting.
- * Debugging with TeX:: How to catch errors with @TeX{} formatting.
- * Using texinfo-show-structure:: How to use @code{texinfo-show-structure}.
-@@ -2286,7 +2286,7 @@
- you must run the @code{texindex} command after first running the
- @code{tex} typesetting command; and then you must run the @code{tex}
- command again. Or else run the @code{texi2dvi} command which
--automatically creates indices as needed (@pxref{Format with texi2dvi}).
-+automatically creates indices as needed (@pxref{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
-@@ -3877,8 +3877,8 @@
-
- You need to include the @code{@@set@dots{}contentsaftertitlepage}
- commands early in the document (just after @code{@@setfilename}, for
--example). Or, if you're using @command{texi2dvi} (@pxref{Format with
--texi2dvi}), you can use its @option{--texinfo} option to specify this
-+example). Or, if you're using @command{texi2dvi} (@pxref{texi2dvi}),
-+you can use its @option{--texinfo} option to specify this
- without altering the source file at all. For example:
- @example
- texi2dvi --texinfo=@@setshortcontentsaftertitlepage foo.texi
-@@ -12629,8 +12629,8 @@
-
- @menu
- * Use TeX:: Use @TeX{} to format for hardcopy.
--* Format with tex/texindex:: How to format with explicit shell commands.
--* Format with texi2dvi:: A simpler way to format.
-+* texindex:: How to format with explicit shell commands.
-+* texi2dvi:: A simpler way to format.
- * Print with lpr:: How to print.
- * Within Emacs:: How to format and print from an Emacs shell.
- * Texinfo Mode Printing:: How to format and print in Texinfo mode.
-@@ -12660,7 +12660,7 @@
- make an Info file (@pxref{Creating an Info File}).
-
-
--@node Format with tex/texindex
-+@node texindex
- @section Format with @code{tex} and @code{texindex}
- @cindex Shell formatting with @code{tex} and @code{texindex}
- @cindex Formatting with @code{tex} and @code{texindex}
-@@ -12681,7 +12681,7 @@
- @pindex texindex
- The @code{tex} formatting command itself does not sort the indices; it
- writes an output file of unsorted index data. (The @code{texi2dvi}
--command automatically generates indices; @pxref{Format with texi2dvi,,
-+command automatically generates indices; @pxref{texi2dvi,,
- Format with @code{texi2dvi}}.) To generate a printed index after
- running the @code{tex} command, you first need a sorted index to work
- from. The @code{texindex} command sorts indices. (The source file
-@@ -12755,7 +12755,7 @@
-
- @pindex texi2dvi
- Alternatively, it's a one-step process: run @code{texi2dvi}
--(@pxref{Format with texi2dvi}).
-+(@pxref{texi2dvi}).
-
- You need not run @code{texindex} each time after you run @code{tex}. If
- you do not, on the next run, the @code{tex} formatting command will use
-@@ -12787,7 +12787,7 @@
- (@pxref{Pointer Validation}).
-
-
--@node Format with texi2dvi
-+@node texi2dvi
- @section Format with @code{texi2dvi}
+ @set txiindexatsignignore
+@@ -1171,7 +1171,7 @@ processed from standard input, without a
+ base file name from, @code{@@setfilename} could still be relevant.
+ This is not the only way, however: @option{--output} option specifies
+ the output file name on the @command{texi2any} command-line
+-(@pxref{Invoking @command{texi2any}}).
++(@pxref{@command{texi2any}}).
+
+ @cindex Length of file names
+ @cindex File name collision
+@@ -11845,8 +11845,7 @@ included. This will generally not be th
+ itself, but will usually be the case for up-to-date distributions of
+ the extended @TeX{} programs @command{etex} (DVI output) and
+ @command{pdftex} (PDF output). @command{texi2dvi} will use the
+-extended @TeX{}s if they are available (@pxref{Format with
+-@command{texi2dvi}}).
++extended @TeX{}s if they are available (@pxref{@command{texi2dvi}}).
+
+ @cindex ISO 639-2 language codes
+ @cindex ISO 3166 country codes
+@@ -13163,8 +13162,8 @@ Also, quite a few macro-related construc
+ some of the caveats are listed below. Thus, if you get macro-related
+ errors when producing the printed version of a manual, you might try
+ expanding the macros with @command{texi2any} by invoking
+-@command{texi2dvi} with the @samp{-E} option (@pxref{Format with
+-@command{texi2dvi}}). Or, more reliably, eschew Texinfo macros altogether
++@command{texi2dvi} with the @samp{-E} option (@pxref{@command{texi2dvi}}).
++Or, more reliably, eschew Texinfo macros altogether
+ and use a language designed for macro processing, such as M4
+ (@pxref{External Macro Processors}).
+
+@@ -13704,8 +13703,8 @@ use @command{texi2any}'s macro expansion
+
+ @itemize @bullet
+ @item
+-If you run @command{texi2dvi} or its variants (@pxref{Format with
+-@command{texi2dvi}}), you can pass @option{-E} and @command{texi2dvi}
++If you run @command{texi2dvi} or its variants (@pxref{@command{texi2dvi}}),
++you can pass @option{-E} and @command{texi2dvi}
+ will run @command{texi2any} first to expand macros and eliminate
+ @samp{#line}.
+
+@@ -13991,7 +13990,7 @@ process in which you use the @TeX{} prog
+ you may also create indices using the @command{texindex} command
+ after first running @TeX{}; and then you must run @TeX{} again.
+ @command{texi2dvi} takes care of all of this, running @TeX{} and
+-@command{texindex} as needed (@pxref{Format with @command{texi2dvi}}).
++@command{texindex} as needed (@pxref{@command{texi2dvi}}).
+
+ @anchor{Within Emacs} @c old node name
+ @anchor{Emacs Shell Printing} @c old node name
+@@ -14035,16 +14034,16 @@ and you can get it over the Internet or
+ @c please keep that text in sync with www.gnu.org/prep/FTP
+
+
+-@node Format with @command{texi2dvi} or @command{texi2pdf}
++@node @command{texi2dvi} or @command{texi2pdf}
+ @nodedescription The simplest way to format.
+-@section Format with @command{texi2dvi} or @command{texi2pdf}
++@section @command{texi2dvi} or @command{texi2pdf}
+
+ @c previously in a separate node. To be used when referring
+ @c only to PDF output, as is the case in @direntry
+ @anchor{PDF Output}
+ @c To be used when referring to DVI output or to texi2dvi only,
+ @c as is the case in @direntry
+-@anchor{Format with @command{texi2dvi}}
++@anchor{@command{texi2dvi}}
+
@pindex texi2dvi @r{(shell script)}
+ @pindex texi2pdf @r{(shell script)}
+@@ -14202,7 +14201,7 @@ The default is @samp{nomaybe}. This env
+ for troubleshooting purposes, and may change or disappear in the future.
-@@ -12823,7 +12823,7 @@
- For a list of other options, run @samp{texi2dvi --help}.
-
-
--@node Print with lpr, Within Emacs, Format with texi2dvi, Hardcopy
-+@node Print with lpr, Within Emacs, texi2dvi, Hardcopy
- @section Shell Print Using @code{lpr -d}
- @pindex lpr @r{(DVI print command)}
-
-@@ -13331,7 +13331,7 @@
- @xref{small}, for information about
- commands that make it easier to produce examples for a smaller manual.
-
--@xref{Format with texi2dvi}, and @ref{Preparing for TeX,,Preparing for
-+@xref{texi2dvi}, and @ref{Preparing for TeX,,Preparing for
- @TeX{}}, for other ways to format with @code{@@smallbook} that do not
- require changing the source file.
-
-@@ -13360,7 +13360,7 @@
- @end group
- @end example
-
--@xref{Format with texi2dvi}, and @ref{Preparing for TeX,,Preparing for
-+@xref{texi2dvi}, and @ref{Preparing for TeX,,Preparing for
- @TeX{}}, for other ways to format with @code{@@afourpaper} that do not
- require changing the source file.
-
-@@ -13406,7 +13406,7 @@
- margins, you must define a new command in @file{texinfo.tex} (or
- @file{texinfo.cnf}, @pxref{Preparing for TeX,,Preparing for @TeX{}}).
-
--@xref{Format with texi2dvi}, and @ref{Preparing for TeX,,Preparing for
-+@xref{texi2dvi}, and @ref{Preparing for TeX,,Preparing for
- @TeX{}}, for other ways to specify @code{@@pagesizes} that do not
- require changing the source file.
-
-@@ -14222,7 +14222,7 @@
- located in other directories.
- * Installing Dir Entries:: How to specify what menu entry to add
- to the Info directory.
--* Invoking install-info:: @code{install-info} options.
-+* install-info:: @code{install-info} options.
- @end menu
-
-
-@@ -14447,7 +14447,7 @@
- special CTRL-_ character that Info needs will be present.
-
-
--@node Installing Dir Entries, Invoking install-info, Other Info Directories, Install an Info File
-+@node Installing Dir Entries, install-info, Other Info Directories, Install an Info File
- @subsection Installing Info Directory Files
-
- When you install an Info file onto your system, you can use the program
-@@ -14468,7 +14468,7 @@
- @@dircategory Texinfo documentation system
- @@direntry
- * Texinfo: (texinfo). The GNU documentation format.
--* install-info: (texinfo)Invoking install-info. @dots{}
-+* install-info: (texinfo)install-info. @dots{}
- @dots{}
- @@end direntry
- @end smallexample
-@@ -14479,7 +14479,7 @@
- INFO-DIR-SECTION Texinfo documentation system
- START-INFO-DIR-ENTRY
- * Texinfo: (texinfo). The GNU documentation format.
--* install-info: (texinfo)Invoking install-info. @dots{}
-+* install-info: (texinfo)install-info. @dots{}
- @dots{}
- END-INFO-DIR-ENTRY
- @end smallexample
-@@ -14505,8 +14505,8 @@
- entry for the manual as a whole in the appropriate other category.
-
-
--@node Invoking install-info
--@subsection Invoking install-info
-+@node install-info
-+@subsection install-info
-
- @pindex install-info
-
-@@ -17047,7 +17047,7 @@
- command and you can use the @kbd{M-x Info-validate} command.@refill
-
- @menu
--* makeinfo Preferred:: @code{makeinfo} finds errors.
-+* makeinfo:: @code{makeinfo} finds errors.
- * Debugging with Info:: How to catch errors with Info formatting.
- * Debugging with TeX:: How to catch errors with @TeX{} formatting.
- * Using texinfo-show-structure:: How to use @code{texinfo-show-structure}.
-@@ -17055,7 +17055,7 @@
- * Running Info-Validate:: How to find badly referenced nodes.
- @end menu
-
--@node makeinfo Preferred, Debugging with Info, Catching Mistakes, Catching Mistakes
-+@node makeinfo, Debugging with Info, Catching Mistakes, Catching Mistakes
- @ifinfo
- @heading @code{makeinfo} Find Errors
- @end ifinfo
-@@ -17074,7 +17074,7 @@
- cannot use @code{makeinfo}, or your problem is very puzzling, then you
- may want to use the tools described in this appendix.@refill
-
--@node Debugging with Info, Debugging with TeX, makeinfo Preferred, Catching Mistakes
-+@node Debugging with Info, Debugging with TeX, makeinfo, Catching Mistakes
- @comment node-name, next, previous, up
- @section Catching Errors with Info Formatting
- @cindex Catching errors with Info formatting
+
+-@node Format with @command{tex}/@command{texindex}
++@node @command{tex}/@command{texindex}
+ @nodedescription Formatting with explicit shell commands.
+ @section Format with @command{tex}/@command{texindex}
+
+@@ -14336,7 +14335,7 @@ Thus, the beginning of your file would l
+
+ @noindent @code{@@novalidate} also turns off validation in
+ @command{texi2any}, just like its @code{--no-validate} option
+-(@pxref{Invoking @command{texi2any}}).
++(@pxref{@command{texi2any}}).
+
+ Furthermore, you need not run @command{texindex} each time after you run
+ @command{tex}. The @command{tex} formatting command simply uses whatever
+@@ -14395,7 +14394,7 @@ file directly.
+
+ For example, the following commands will (probably) suffice to sort
+ the indices, format, and print this manual using the @command{texi2dvi}
+-shell script (@pxref{Format with @command{texi2dvi}}).
++shell script (@pxref{@command{texi2dvi}}).
+
+ @example
+ @group
+@@ -14616,11 +14615,11 @@ anything which can be specified on the c
+ specified within a initialization file.
+
+
+-@node Invoking @command{texi2any}
++@node @command{texi2any}
+ @nodedescription Running the translator from a shell.
+ @section Invoking @command{texi2any} from a Shell
+
+-@anchor{Invoking makeinfo}
++@anchor{makeinfo}
+ @pindex makeinfo
+ @pindex texi2any
+
+@@ -15275,8 +15274,8 @@ tricks together with @file{texinfo.tex},
+ @command{texi2dvi} directly.
+
+ The output format options for this are @option{--dvi},
+-@option{--dvipdf}, @option{--pdf}, and @option{--ps}. @xref{Format
+-with @command{texi2dvi}}, for more details on these options and general
++@option{--dvipdf}, @option{--pdf}, and @option{--ps}.
++@xref{@command{texi2dvi}}, for more details on these options and general
+ @command{texi2dvi} operation. In addition, the @option{--verbose},
+ @option{--silent}, and @option{--quiet} options are passed on if
+ specified; the @option{-I} and @option{-o} options are likewise passed
+@@ -15413,7 +15412,7 @@ variables may not be passed on to @TeX{}
+ @cindex Options, customization variables for
+
+ The following table gives the customization variables associated with
+-some command line options. @xref{Invoking @command{texi2any}}, for the
++some command line options. @xref{@command{texi2any}}, for the
+ meaning of the options.
+
+ @multitable @columnfractions 0.5 0.5
+@@ -15487,7 +15486,7 @@ forms:
+ @itemx xml
+ These correspond to the command-line options (and
+ @code{TEXINFO_OUTPUT_FORMAT} environment variable values) of the same
+-name. @xref{Invoking @command{texi2any}}.
++name. @xref{@command{texi2any}}.
+
+ @cindex tree representation, for debugging
+ @cindex debugging document, with tree representation
+@@ -16130,13 +16129,13 @@ output quotation marks.
+ For Info output, column at which to start a menu entry description
+ provided by @code{@@nodedescription} or @code{@@nodedescriptionblock}.
+ Undefined by default, in which case 45% of the fill column value is used
+-(@pxref{Invoking @command{texi2any}}).
++(@pxref{@command{texi2any}}).
+
+ @item AUTO_MENU_MAX_WIDTH
+ Maximum number of columns in a menu entry line in Info when adding a
+ description from @code{@@nodedescription} or @code{@@nodedescriptionblock}.
+ Undefined by default, in which case 10% more than the fill column value
+-is used (@pxref{Invoking @command{texi2any}}).
++is used (@pxref{@command{texi2any}}).
+
+ @item CHECK_MISSING_MENU_ENTRY
+ When a @code{@@menu} block occurs in a node, check if there is a menu
+@@ -16488,7 +16487,7 @@ This may be remedied in a future release
+
+ The following transformations are currently supported (many are used
+ in the @code{pod2texi} utility distributed with Texinfo;
+-@pxref{Invoking @command{pod2texi}}):
++@pxref{@command{pod2texi}}):
+
+ @ftable @samp
+ @item complete_tree_nodes_menus
+@@ -16670,7 +16669,7 @@ format, while nevertheless with rich for
+ appropriately in many languages.
+
+
+-@node Invoking @command{pod2texi}
++@node @command{pod2texi}
+ @nodedescription Translating Perl Pod to Texinfo.
+ @section Invoking @command{pod2texi}: Convert Pod to Texinfo
+
+@@ -17063,7 +17062,7 @@ start at column 32, starting at zero (as
+ most others. Description for individual utilities best start in
+ column 48, where possible. For more information about formatting see
+ the @samp{--calign}, @samp{--align}, and @samp{--max-width} options in
+-@ref{Invoking @command{install-info}}.
++@ref{@command{install-info}}.
+
+ If you use @code{@@dircategory} more than once in the Texinfo source,
+ each usage specifies the `current' category; any subsequent
+@@ -17076,7 +17075,7 @@ documentation for the different programs
+ traditional @command{man} system.
+
+
+-@node Invoking @command{install-info}
++@node @command{install-info}
+ @nodedescription @code{install-info} options.
+ @subsection Invoking @command{install-info}
+
+@@ -17323,7 +17322,7 @@ large Info file into shorter @dfn{indire
+ 300,000 characters each. With @command{texi2any}, splitting
+ may be prevented by @option{--no-split}, and the default size
+ of 300,000 characters may be modified with @option{--split-size}
+-(@pxref{Invoking @command{texi2any}}).
++(@pxref{@command{texi2any}}).
+
+ When a file is split, Info itself makes use of a shortened version of
+ the original file that contains just the tag table and references to
+@@ -17505,7 +17504,7 @@ Variables}. In particular, there is sup
+ @code{@@example} (@pxref{Syntax Highlighting}). You can also write so-called
+ @dfn{initialization files}, or @dfn{init files} for short, to modify almost
+ every aspect of HTML output formatting. Initialization files contain code and
+-are loaded by @option{--init-file} (@pxref{Invoking @command{texi2any}}).
++are loaded by @option{--init-file} (@pxref{@command{texi2any}}).
+
+ Some initialization files are maintained with Texinfo and installed
+ in the default case. For example, @file{chm.pm} produces the intermediate
+@@ -17595,7 +17594,7 @@ insensitive filesystem by setting the cu
+ @code{CASE_INSENSITIVE_FILENAMES}.
+
+ It is also possible to split at chapters or sections with
+-@option{--split} (@pxref{Invoking @command{texi2any}}). In that case,
++@option{--split} (@pxref{@command{texi2any}}). In that case,
+ the file names are constructed after the name of the node associated
+ with the relevant sectioning command. Also, unless
+ @option{--no-node-files} is specified, a redirection file is output
+@@ -17816,7 +17815,7 @@ The EPUB output file is not generated if
+ is left after the final EPUB file has been generated if
+ @code{EPUB_KEEP_CONTAINER_FOLDER} is set.
+
+-@xref{Invoking @command{texi2any}}.
++@xref{@command{texi2any}}.
+
+
+ @node EPUB Cross-References
+@@ -23111,7 +23110,7 @@ have been called the @code{@@regularbook
+ called the @code{@@smallbook} command by comparison to the 8.5 by 11
+ inch format.)
+
+-@xref{Format with @command{texi2dvi} or @command{texi2pdf}},
++@xref{@command{texi2dvi} or @command{texi2pdf}},
+ and @ref{Preparing for @TeX{}}, for other ways to format with
+ @code{@@smallbook} with @TeX{} that do not require changing the source file.
+
+@@ -23137,7 +23136,7 @@ You may or may not prefer the formatting
+ wide format, @code{@@afivepaper} for A5 paper, and @code{@@bsixpaper} for
+ B6 paper.
+
+-@xref{Format with @command{texi2dvi} or @command{texi2pdf}}
++@xref{@command{texi2dvi} or @command{texi2pdf}}
+ and @ref{Preparing for @TeX{}}, for other ways to format for different
+ paper sizes that do not require changing the source file.
+
+@@ -23181,7 +23180,7 @@ To make more elaborate changes, such as
+ margins, you must define a new command in @file{texinfo.tex} or
+ @file{texinfo.cnf}.
+
+-@xref{Format with @command{texi2dvi} or @command{texi2pdf}},
++@xref{@command{texi2dvi} or @command{texi2pdf}},
+ and @ref{Preparing for @TeX{}}, for other ways to specify
+ @code{@@pagesizes} that do not require changing the source file.
+
+--- texinfo-7.1/doc/pod2texi.texi.orig 2023-08-15 14:06:23.000000000 +0200
++++ texinfo-7.1/doc/pod2texi.texi 2023-11-07 22:11:30.144286396 +0100
+@@ -1,5 +1,4 @@
+ @subsection pod2texi
+-@anchor{pod2texi}
+
+ @subsubheading pod2texi NAME
+ @anchor{pod2texi NAME}
projects / packages / texinfo.git / blobdiff