- updated to 6.4

[packages/texinfo.git] / texinfo-info.patch

--- texinfo-6.0/doc/info-stnd.texi.orig	2015-07-17 21:06:08.870188902 +0200
+++ texinfo-6.0/doc/info-stnd.texi	2015-07-17 21:09:52.940179499 +0200
@@ -41,9 +41,9 @@
 license to the document, as described in section 6 of the license.
 @end copying
 
-@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-6.4/doc/texinfo.texi.orig	2017-05-24 21:50:37.000000000 +0200
+++ texinfo-6.4/doc/texinfo.texi	2017-06-29 21:30:29.610768169 +0200
@@ -55,16 +55,16 @@
 @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.
-* makeinfo: (texinfo)Invoking makeinfo.         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.
+* Texinfo: (texinfo).			The GNU documentation format
+* install-info: (texinfo)install-info.	Update info/dir entries
+* makeinfo: (texinfo)makeinfo.		Translate Texinfo source
+* pod2texi: (pod2texi)pod2texi.		Translate Perl POD to Texinfo
+* texi2dvi: (texinfo)texi2dvi.		Print Texinfo documents
+* texi2pdf: (texinfo)texi2pdf.		PDF output for Texinfo
+* pdftexi2dvi: (texinfo)pdftexi2dvi.	PDF output for Texinfo
+* texindex: (texinfo)tex/texindex.	Sort Texinfo index files
 @end direntry
 
 @c Set smallbook if printing in smallbook format so the example of the
@@ -557,8 +557,8 @@
 Formatting and Printing Hardcopy
 
 * Use @TeX{}::                     Use @TeX{} to format for hardcopy.
-* Format with @command{texi2dvi}::        The simplest way to format.
-* Format with @command{tex}/@command{texindex}::    Formatting with explicit shell commands.
+* @command{texi2dvi}::                    The simplest way to format.
+* @command{tex}/@command{texindex}::                Formatting with explicit shell commands.
 * Print with @command{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.
@@ -571,7 +571,7 @@
 * @code{@@pagesizes}::                  How to print with customized page sizes.
 * Cropmarks and Magnification:: How to print marks to indicate the size
                                  of pages and how to print scaled up output.
-* PDF Output::                  Portable Document Format output.
+* texi2pdf::                    Portable Document Format output.
 * Obtaining @TeX{}::               How to obtain @TeX{}.
 
 Format with @command{tex}/@command{texindex}
@@ -582,13 +582,13 @@
 @command{texi2any}: The Generic Translator for Texinfo
 
 * Reference Implementation::    @command{texi2any}: the reference implementation.
-* Invoking @command{texi2any}::           Running the translator from a shell.
+* @command{texi2any}::                    Running the translator from a shell.
 * @command{texi2any} Environment Variables::
 * @command{texi2any} Printed Output::     Calling @command{texi2dvi}.
 * Pointer Validation::          How to check that pointers point somewhere.
 * Customization Variables::     Configuring @command{texi2any}.
 * Internationalization of Document Strings:: Translating program-inserted text.
-* Invoking @command{pod2texi}::           Translating Perl pod to Texinfo.
+* @command{pod2texi}::                    Translating Perl pod to Texinfo.
 * @command{texi2html}::                   An ancestor of @command{texi2any}.
 
 Customization Variables
@@ -622,7 +622,7 @@
                                  located in other directories.
 * Installing Dir Entries::      How to specify what menu entry to add
                                  to the Info directory.
-* Invoking @command{install-info}::       @code{install-info} options.
+* @command{install-info}::                @code{install-info} options.
 
 Generating HTML
 
@@ -955,7 +955,7 @@
 @uref{http://tug.org/TUGboat/tb22-3/tb72beebe-pdf.pdf} have some
 background.  By default, Texinfo uses the @command{pdftex} program, an
 extension of @TeX{}, to output PDF; see
-@uref{http://tug.org/applications/pdftex}.  @xref{PDF Output}.
+@uref{http://tug.org/applications/pdftex}.  @xref{texi2pdf}.
 
 @item Docbook
 @cindex Docbook output, overview
@@ -1966,7 +1966,7 @@
 the original file name to leave enough space for the subfile suffix,
 thus producing files named @file{texin-10}, @file{gcc.i12}, etc.
 
-See also the @option{--output} option in @ref{Invoking @command{texi2any}}.
+See also the @option{--output} option in @ref{@command{texi2any}}.
 
 
 @node @code{@@settitle}
@@ -12686,8 +12686,7 @@
 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}}).
 
 In September 2006, the W3C Internationalization Activity released a
 new recommendation for specifying languages:
@@ -14009,8 +14008,8 @@
 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{makeinfo} 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}).
 
@@ -14433,8 +14432,8 @@
 
 @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{makeinfo} first to expand macros and eliminate
 @samp{#line}.
 
@@ -14836,8 +14835,8 @@
 
 @menu
 * Use @TeX{}::                     Use @TeX{} to format for hardcopy.
-* Format with @command{texi2dvi}::        The simplest way to format.
-* Format with @command{tex}/@command{texindex}::    Formatting with explicit shell commands.
+* @command{texi2dvi}::                    The simplest way to format.
+* @command{tex}/@command{texindex}::                Formatting with explicit shell commands.
 * Print with @command{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.
@@ -14850,7 +14849,7 @@
 * @code{@@pagesizes}::                  How to print with customized page sizes.
 * Cropmarks and Magnification:: How to print marks to indicate the size
                                  of pages and how to print scaled up output.
-* PDF Output::                  Portable Document Format output.
+* texi2pdf::                    Portable Document Format output.
 * Obtaining @TeX{}::               How to obtain @TeX{}.
 @end menu
 
@@ -14867,7 +14866,7 @@
 in itself.
 
 
-@node Format with @command{texi2dvi}
+@node @command{texi2dvi}
 @section Format with @command{texi2dvi}
 
 @pindex texi2dvi @r{(shell script)}
@@ -14897,7 +14896,7 @@
 @opindex --pdf@r{, for @command{texi2dvi}}
 @pindex pdftexi2dvi
 With the @option{--pdf} option, @command{texi2dvi} produces PDF output
-instead of DVI (@pxref{PDF Output}), by running @command{pdftex}
+instead of DVI (@pxref{texi2pdf}), by running @command{pdftex}
 instead of @command{tex}.  Alternatively, the command
 @command{texi2pdf} is an abbreviation for running @samp{texi2dvi
 --pdf}.  The command @command{pdftexi2dvi} is also provided as a
@@ -15031,7 +15030,7 @@
 for troubleshooting purposes, and may change or disappear in the future.
 
 
-@node Format with @command{tex}/@command{texindex}
+@node @command{tex}/@command{texindex}
 @section Format with @command{tex}/@command{texindex}
 
 @cindex Shell formatting with @code{tex} and @code{texindex}
@@ -15245,7 +15244,7 @@
 
 For example, the following commands will (probably) suffice to sort
 the indices, format, and print this manual using the @code{texi2dvi}
-shell script (@pxref{Format with @command{texi2dvi}}).
+shell script (@pxref{@command{texi2dvi}}).
 
 @example
 @group
@@ -15718,7 +15717,7 @@
 @xref{@code{@@small@dots{}}}, for information about commands that make
 it easier to produce examples for a smaller manual.
 
-@xref{Format with @command{texi2dvi}}, and @ref{Preparing for @TeX{}},
+@xref{@command{texi2dvi}}, and @ref{Preparing for @TeX{}},
 for other ways to format with @code{@@smallbook} that do not require
 changing the source file.
 
@@ -15748,7 +15747,7 @@
 @end group
 @end example
 
-@xref{Format with @command{texi2dvi}}, and @ref{Preparing for @TeX{}},
+@xref{@command{texi2dvi}}, and @ref{Preparing for @TeX{}},
 for other ways to format for different paper sizes that do not require
 changing the source file.
 
@@ -15797,7 +15796,7 @@
 margins, you must define a new command in @file{texinfo.tex} or
 @file{texinfo.cnf}.
 
-@xref{Format with @command{texi2dvi}}, and @ref{Preparing for @TeX{}},
+@xref{@command{texi2dvi}}, and @ref{Preparing for @TeX{}},
 for other ways to specify @code{@@pagesizes} that do not require
 changing the source file.
 
@@ -15863,7 +15862,7 @@
 magnifications.  Be prepared to experiment.
 
 
-@node PDF Output
+@node texi2pdf
 @section PDF Output
 @cindex PDF output
 @cindex Output, in PDF
@@ -15872,7 +15871,7 @@
 The simplest way to generate PDF output from Texinfo source is to run
 the convenience script @command{texi2pdf} (or @command{pdftexi2dvi});
 this executes the @command{texi2dvi} script with the @option{--pdf}
-option (@pxref{Format with @command{texi2dvi}}).  If for some reason you
+option (@pxref{@command{texi2dvi}}).  If for some reason you
 want to process the document by hand, you can run the @command{pdftex}
 program instead of plain @command{tex}.  That is, run @samp{pdftex
 foo.texi} instead of @samp{tex foo.texi}.
@@ -15959,13 +15958,13 @@
 
 @menu
 * Reference Implementation::    @command{texi2any}: the reference implementation.
-* Invoking @command{texi2any}::           Running the translator from a shell.
+* @command{texi2any}::                    Running the translator from a shell.
 * @command{texi2any} Environment Variables::
 * @command{texi2any} Printed Output::     Calling @command{texi2dvi}.
 * Pointer Validation::          How to check that pointers point somewhere.
 * Customization Variables::     Configuring @command{texi2any}.
 * Internationalization of Document Strings:: Translating program-inserted text.
-* Invoking @command{pod2texi}::           Translating Perl pod to Texinfo.
+* @command{pod2texi}::                    Translating Perl pod to Texinfo.
 * @command{texi2html}::                   An ancestor of @command{texi2any}.
 @end menu
 
@@ -16026,10 +16025,10 @@
 @command{texi2any}.
 
 
-@node Invoking @command{texi2any}
+@node @command{texi2any}
 @section Invoking @command{texi2any}/@command{makeinfo} from a Shell
 
-@anchor{Invoking makeinfo}
+@anchor{makeinfo}
 @pindex makeinfo
 @pindex texi2any
 
@@ -16604,8 +16603,8 @@
 @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
@@ -16778,7 +16777,7 @@
 @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
@@ -16871,7 +16870,7 @@
 @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}}.
 
 @item debugtree
 @cindex tree representation, for debugging
@@ -17515,7 +17514,7 @@
 
 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
@@ -17686,7 +17685,7 @@
 appropriately in many languages.
 
 
-@node Invoking @command{pod2texi}
+@node @command{pod2texi}
 @section Invoking @command{pod2texi}: Convert POD to Texinfo
 
 @pindex pod2texi
@@ -18142,7 +18141,7 @@
                                  located in other directories.
 * Installing Dir Entries::      How to specify what menu entry to add
                                  to the Info directory.
-* Invoking @command{install-info}::       @code{install-info} options.
+* @command{install-info}::                @code{install-info} options.
 @end menu
 
 
@@ -18380,7 +18379,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
@@ -18391,7 +18390,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
@@ -18413,7 +18412,7 @@
 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
@@ -18448,7 +18447,7 @@
 traditional @command{man} system.
 
 
-@node Invoking @command{install-info}
+@node @command{install-info}
 @subsection Invoking @command{install-info}
 
 @pindex install-info
@@ -18716,7 +18715,7 @@
 @pindex html32.pm
 Some known exceptions to HTML@tie{}3.2 (using
 @samp{--init-file=html32.pm} produces strict HTML@tie{}3.2 output;
-@pxref{Invoking @command{texi2any}}):
+@pxref{@command{texi2any}}):
 
 @enumerate
 @item
@@ -18818,7 +18817,7 @@
 @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
@@ -22449,8 +22448,7 @@
 this, 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
-@command{texi2dvi}}).
+automatically creates indices as needed (@pxref{@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