texinfo-info.patch

   1 --- texinfo-6.0/doc/info-stnd.texi.orig 2015-07-17 21:06:08.870188902 +0200
   2 +++ texinfo-6.0/doc/info-stnd.texi      2015-07-17 21:09:52.940179499 +0200
   3 @@ -41,9 +41,9 @@
   4  license to the document, as described in section 6 of the license.
   5  @end copying
   6
   7 -@dircategory Texinfo documentation system
   8 +@dircategory Texinfo documentation system:
   9  @direntry
  10 -* info stand-alone: (info-stnd).           Read Info documents without Emacs.
  11 +* info stand-alone: (info-stnd).       Read Info documents without Emacs
  12  @end direntry
  13
  14  @titlepage
  15 --- texinfo-6.1/doc/texinfo.texi.orig   2016-02-06 10:04:55.000000000 +0100
  16 +++ texinfo-6.1/doc/texinfo.texi        2016-02-20 10:19:40.158531500 +0100
  17 @@ -55,16 +55,16 @@
  18  @end quotation
  19  @end copying
  20
  21 -@dircategory Texinfo documentation system
  22 +@dircategory Texinfo documentation system:
  23  @direntry
  24 -* Texinfo: (texinfo).           The GNU documentation format.
  25 -* install-info: (texinfo)Invoking install-info. Update info/dir entries.
  26 -* makeinfo: (texinfo)Invoking makeinfo.         Translate Texinfo source.
  27 -* pod2texi: (pod2texi)Invoking pod2texi.        Translate Perl POD to Texinfo.
  28 -* texi2dvi: (texinfo)Format with texi2dvi.      Print Texinfo documents.
  29 -* texi2pdf: (texinfo)PDF Output.                PDF output for Texinfo.
  30 -* pdftexi2dvi: (texinfo)PDF Output.             PDF output for Texinfo.
  31 -* texindex: (texinfo)Format with tex/texindex.  Sort Texinfo index files.
  32 +* Texinfo: (texinfo).                  The GNU documentation format
  33 +* install-info: (texinfo)install-info. Update info/dir entries
  34 +* makeinfo: (texinfo)makeinfo.         Translate Texinfo source
  35 +* pod2texi: (pod2texi)pod2texi.                Translate Perl POD to Texinfo.
  36 +* texi2dvi: (texinfo)texi2dvi.         Print Texinfo documents
  37 +* texi2pdf: (texinfo)texi2pdf.         PDF output for Texinfo
  38 +* pdftexi2dvi: (texinfo)pdftexi2dvi.   PDF output for Texinfo
  39 +* texindex: (texinfo)tex/texindex.     Sort Texinfo index files
  40  @end direntry
  41
  42  @c Set smallbook if printing in smallbook format so the example of the
  43 @@ -557,8 +557,8 @@
  44  Formatting and Printing Hardcopy
  45
  46  * Use @TeX{}::                     Use @TeX{} to format for hardcopy.
  47 -* Format with @command{texi2dvi}::        The simplest way to format.
  48 -* Format with @command{tex}/@command{texindex}::    Formatting with explicit shell commands.
  49 +* @command{texi2dvi}::                    The simplest way to format.
  50 +* @command{tex}/@command{texindex}::                Formatting with explicit shell commands.
  51  * Print with @command{lpr}::              How to print.
  52  * Within Emacs::                How to format and print from an Emacs shell.
  53  * Texinfo Mode Printing::       How to format and print in Texinfo mode.
  54 @@ -571,7 +571,7 @@
  55  * @code{@@pagesizes}::                  How to print with customized page sizes.
  56  * Cropmarks and Magnification:: How to print marks to indicate the size
  57                                   of pages and how to print scaled up output.
  58 -* PDF Output::                  Portable Document Format output.
  59 +* texi2pdf::                    Portable Document Format output.
  60  * Obtaining @TeX{}::               How to obtain @TeX{}.
  61
  62  Format with @command{tex}/@command{texindex}
  63 @@ -582,12 +582,12 @@
  64  @command{texi2any}: The Generic Translator for Texinfo
  65
  66  * Reference Implementation::    @command{texi2any}: the reference implementation.
  67 -* Invoking @command{texi2any}::           Running the translator from a shell.
  68 +* @command{texi2any}::                    Running the translator from a shell.
  69  * @command{texi2any} Printed Output::     Calling @command{texi2dvi}.
  70  * Pointer Validation::          How to check that pointers point somewhere.
  71  * Customization Variables::     Configuring @command{texi2any}.
  72  * Internationalization of Document Strings:: Translating program-inserted text.
  73 -* Invoking @command{pod2texi}::           Translating Perl pod to Texinfo.
  74 +* @command{pod2texi}::                    Translating Perl pod to Texinfo.
  75  * @command{texi2html}::                   An ancestor of @command{texi2any}.
  76
  77  Customization Variables
  78 @@ -621,7 +621,7 @@
  79                                   located in other directories.
  80  * Installing Dir Entries::      How to specify what menu entry to add
  81                                   to the Info directory.
  82 -* Invoking @command{install-info}::       @code{install-info} options.
  83 +* @command{install-info}::                @code{install-info} options.
  84
  85  Generating HTML
  86
  87 @@ -954,7 +954,7 @@
  88  @uref{http://tug.org/TUGboat/tb22-3/tb72beebe-pdf.pdf} have some
  89  background.  By default, Texinfo uses the @command{pdftex} program, an
  90  extension of @TeX{}, to output PDF; see
  91 -@uref{http://tug.org/applications/pdftex}.  @xref{PDF Output}.
  92 +@uref{http://tug.org/applications/pdftex}.  @xref{texi2pdf}.
  93
  94  @item Docbook
  95  @cindex Docbook output, overview
  96 @@ -1961,7 +1961,7 @@
  97  the original file name to leave enough space for the subfile suffix,
  98  thus producing files named @file{texin-10}, @file{gcc.i12}, etc.
  99
 100 -See also the @option{--output} option in @ref{Invoking @command{texi2any}}.
 101 +See also the @option{--output} option in @ref{@command{texi2any}}.
 102
 103
 104  @node @code{@@settitle}
 105 @@ -12716,8 +12716,7 @@
 106  itself, but will usually be the case for up-to-date distributions of
 107  the extended @TeX{} programs @command{etex} (DVI output) and
 108  @command{pdftex} (PDF output).  @command{texi2dvi} will use the
 109 -extended @TeX{}s if they are available (@pxref{Format with
 110 -@command{texi2dvi}}).
 111 +extended @TeX{}s if they are available (@pxref{@command{texi2dvi}}).
 112
 113  In September 2006, the W3C Internationalization Activity released a
 114  new recommendation for specifying languages:
 115 @@ -14040,8 +14039,8 @@
 116  some of the caveats are listed below.  Thus, if you get macro-related
 117  errors when producing the printed version of a manual, you might try
 118  expanding the macros with @command{makeinfo} by invoking
 119 -@command{texi2dvi} with the @samp{-E} option (@pxref{Format with
 120 -@command{texi2dvi}}).  Or, more reliably, eschew Texinfo macros altogether
 121 +@command{texi2dvi} with the @samp{-E} option (@pxref{@command{texi2dvi}}).
 122 +Or, more reliably, eschew Texinfo macros altogether
 123  and use a language designed for macro processing, such as M4
 124  (@pxref{External Macro Processors}).
 125
 126 @@ -14433,8 +14432,8 @@
 127
 128  @itemize @bullet
 129  @item
 130 -If you run @command{texi2dvi} or its variants (@pxref{Format with
 131 -@command{texi2dvi}}), you can pass @option{-E} and @command{texi2dvi}
 132 +If you run @command{texi2dvi} or its variants (@pxref{@command{texi2dvi}}),
 133 +you can pass @option{-E} and @command{texi2dvi}
 134  will run @command{makeinfo} first to expand macros and eliminate
 135  @samp{#line}.
 136
 137 @@ -14836,8 +14835,8 @@
 138
 139  @menu
 140  * Use @TeX{}::                     Use @TeX{} to format for hardcopy.
 141 -* Format with @command{texi2dvi}::        The simplest way to format.
 142 -* Format with @command{tex}/@command{texindex}::    Formatting with explicit shell commands.
 143 +* @command{texi2dvi}::                    The simplest way to format.
 144 +* @command{tex}/@command{texindex}::                Formatting with explicit shell commands.
 145  * Print with @command{lpr}::              How to print.
 146  * Within Emacs::                How to format and print from an Emacs shell.
 147  * Texinfo Mode Printing::       How to format and print in Texinfo mode.
 148 @@ -14850,7 +14849,7 @@
 149  * @code{@@pagesizes}::                  How to print with customized page sizes.
 150  * Cropmarks and Magnification:: How to print marks to indicate the size
 151                                   of pages and how to print scaled up output.
 152 -* PDF Output::                  Portable Document Format output.
 153 +* texi2pdf::                    Portable Document Format output.
 154  * Obtaining @TeX{}::               How to obtain @TeX{}.
 155  @end menu
 156
 157 @@ -14867,7 +14866,7 @@
 158  in itself.
 159
 160
 161 -@node Format with @command{texi2dvi}
 162 +@node @command{texi2dvi}
 163  @section Format with @command{texi2dvi}
 164
 165  @pindex texi2dvi @r{(shell script)}
 166 @@ -14897,7 +14896,7 @@
 167  @opindex --pdf@r{, for @command{texi2dvi}}
 168  @pindex pdftexi2dvi
 169  With the @option{--pdf} option, @command{texi2dvi} produces PDF output
 170 -instead of DVI (@pxref{PDF Output}), by running @command{pdftex}
 171 +instead of DVI (@pxref{texi2pdf}), by running @command{pdftex}
 172  instead of @command{tex}.  Alternatively, the command
 173  @command{texi2pdf} is an abbreviation for running @samp{texi2dvi
 174  --pdf}.  The command @command{pdftexi2dvi} is also provided as a
 175 @@ -15031,7 +15030,7 @@
 176  for troubleshooting purposes, and may change or disappear in the future.
 177
 178
 179 -@node Format with @command{tex}/@command{texindex}
 180 +@node @command{tex}/@command{texindex}
 181  @section Format with @command{tex}/@command{texindex}
 182
 183  @cindex Shell formatting with @code{tex} and @code{texindex}
 184 @@ -15245,7 +15244,7 @@
 185
 186  For example, the following commands will (probably) suffice to sort
 187  the indices, format, and print this manual using the @code{texi2dvi}
 188 -shell script (@pxref{Format with @command{texi2dvi}}).
 189 +shell script (@pxref{@command{texi2dvi}}).
 190
 191  @example
 192  @group
 193 @@ -15718,7 +15717,7 @@
 194  @xref{@code{@@small@dots{}}}, for information about commands that make
 195  it easier to produce examples for a smaller manual.
 196
 197 -@xref{Format with @command{texi2dvi}}, and @ref{Preparing for @TeX{}},
 198 +@xref{@command{texi2dvi}}, and @ref{Preparing for @TeX{}},
 199  for other ways to format with @code{@@smallbook} that do not require
 200  changing the source file.
 201
 202 @@ -15748,7 +15747,7 @@
 203  @end group
 204  @end example
 205
 206 -@xref{Format with @command{texi2dvi}}, and @ref{Preparing for @TeX{}},
 207 +@xref{@command{texi2dvi}}, and @ref{Preparing for @TeX{}},
 208  for other ways to format for different paper sizes that do not require
 209  changing the source file.
 210
 211 @@ -15797,7 +15796,7 @@
 212  margins, you must define a new command in @file{texinfo.tex} or
 213  @file{texinfo.cnf}.
 214
 215 -@xref{Format with @command{texi2dvi}}, and @ref{Preparing for @TeX{}},
 216 +@xref{@command{texi2dvi}}, and @ref{Preparing for @TeX{}},
 217  for other ways to specify @code{@@pagesizes} that do not require
 218  changing the source file.
 219
 220 @@ -15863,7 +15862,7 @@
 221  magnifications.  Be prepared to experiment.
 222
 223
 224 -@node PDF Output
 225 +@node texi2pdf
 226  @section PDF Output
 227  @cindex PDF output
 228  @cindex Output, in PDF
 229 @@ -15872,7 +15871,7 @@
 230  The simplest way to generate PDF output from Texinfo source is to run
 231  the convenience script @command{texi2pdf} (or @command{pdftexi2dvi});
 232  this executes the @command{texi2dvi} script with the @option{--pdf}
 233 -option (@pxref{Format with @command{texi2dvi}}).  If for some reason you
 234 +option (@pxref{@command{texi2dvi}}).  If for some reason you
 235  want to process the document by hand, you can run the @command{pdftex}
 236  program instead of plain @command{tex}.  That is, run @samp{pdftex
 237  foo.texi} instead of @samp{tex foo.texi}.
 238 @@ -15959,12 +15958,12 @@
 239
 240  @menu
 241  * Reference Implementation::    @command{texi2any}: the reference implementation.
 242 -* Invoking @command{texi2any}::           Running the translator from a shell.
 243 +* @command{texi2any}::                    Running the translator from a shell.
 244  * @command{texi2any} Printed Output::     Calling @command{texi2dvi}.
 245  * Pointer Validation::          How to check that pointers point somewhere.
 246  * Customization Variables::     Configuring @command{texi2any}.
 247  * Internationalization of Document Strings:: Translating program-inserted text.
 248 -* Invoking @command{pod2texi}::           Translating Perl pod to Texinfo.
 249 +* @command{pod2texi}::                    Translating Perl pod to Texinfo.
 250  * @command{texi2html}::                   An ancestor of @command{texi2any}.
 251  @end menu
 252
 253 @@ -16025,10 +16024,10 @@
 254  @command{texi2any}.
 255
 256
 257 -@node Invoking @command{texi2any}
 258 +@node @command{texi2any}
 259  @section Invoking @command{texi2any}/@command{makeinfo} from a Shell
 260
 261 -@anchor{Invoking makeinfo}
 262 +@anchor{makeinfo}
 263  @pindex makeinfo
 264  @pindex texi2any
 265
 266 @@ -16567,8 +16566,8 @@
 267  @command{texi2dvi} directly.
 268
 269  The output format options for this are @option{--dvi},
 270 -@option{--dvipdf}, @option{--pdf}, and @option{--ps}.  @xref{Format
 271 -with @command{texi2dvi}}, for more details on these options and general
 272 +@option{--dvipdf}, @option{--pdf}, and @option{--ps}.  @xref{@command{texi2dvi}},
 273 +for more details on these options and general
 274  @command{texi2dvi} operation.  In addition, the @option{--verbose},
 275  @option{--silent}, and @option{--quiet} options are passed on if
 276  specified; the @option{-I} and @option{-o} options are likewise passed
 277 @@ -16741,7 +16740,7 @@
 278  @cindex Options, customization variables for
 279
 280  The following table gives the customization variables associated with
 281 -some command line options.  @xref{Invoking @command{texi2any}}, for the
 282 +some command line options.  @xref{@command{texi2any}}, for the
 283  meaning of the options.
 284
 285  @multitable @columnfractions 0.5 0.5
 286 @@ -16816,7 +16815,7 @@
 287  @itemx xml
 288  These correspond to the command-line options (and
 289  @code{TEXINFO_OUTPUT_FORMAT} environment variable values) of the same
 290 -name.  @xref{Invoking @command{texi2any}}.
 291 +name.  @xref{@command{texi2any}}.
 292
 293  @item debugcount
 294  Instead of generating a regular output format, output the count of
 295 @@ -17471,7 +17470,7 @@
 296
 297  The following transformations are currently supported (many are used
 298  in the @code{pod2texi} utility distributed with Texinfo;
 299 -@pxref{Invoking @command{pod2texi}}):
 300 +@pxref{@command{pod2texi}}):
 301
 302  @ftable @samp
 303  @item complete_tree_nodes_menus
 304 @@ -17646,7 +17645,7 @@
 305  appropriately in many languages.
 306
 307
 308 -@node Invoking @command{pod2texi}
 309 +@node @command{pod2texi}
 310  @section Invoking @command{pod2texi}: Convert POD to Texinfo
 311
 312  @pindex pod2texi
 313 @@ -18102,7 +18101,7 @@
 314                                   located in other directories.
 315  * Installing Dir Entries::      How to specify what menu entry to add
 316                                   to the Info directory.
 317 -* Invoking @command{install-info}::       @code{install-info} options.
 318 +* @command{install-info}::                @code{install-info} options.
 319  @end menu
 320
 321
 322 @@ -18340,7 +18339,7 @@
 323  @@dircategory Texinfo documentation system
 324  @@direntry
 325  * Texinfo: (texinfo).           The GNU documentation format.
 326 -* install-info: (texinfo)Invoking install-info. @dots{}
 327 +* install-info: (texinfo)install-info. @dots{}
 328  @dots{}
 329  @@end direntry
 330  @end smallexample
 331 @@ -18351,7 +18350,7 @@
 332  INFO-DIR-SECTION Texinfo documentation system
 333  START-INFO-DIR-ENTRY
 334  * Texinfo: (texinfo).           The GNU documentation format.
 335 -* install-info: (texinfo)Invoking install-info. @dots{}
 336 +* install-info: (texinfo)install-info. @dots{}
 337  @dots{}
 338  END-INFO-DIR-ENTRY
 339  @end smallexample
 340 @@ -18373,7 +18372,7 @@
 341  most others.  Description for individual utilities best start in
 342  column 48, where possible.  For more information about formatting see
 343  the @samp{--calign}, @samp{--align}, and @samp{--max-width} options in
 344 -@ref{Invoking @command{install-info}}.
 345 +@ref{@command{install-info}}.
 346
 347  If you use @code{@@dircategory} more than once in the Texinfo source,
 348  each usage specifies the `current' category; any subsequent
 349 @@ -18408,7 +18407,7 @@
 350  traditional @command{man} system.
 351
 352
 353 -@node Invoking @command{install-info}
 354 +@node @command{install-info}
 355  @subsection Invoking @command{install-info}
 356
 357  @pindex install-info
 358 @@ -18676,7 +18675,7 @@
 359  @pindex html32.pm
 360  Some known exceptions to HTML@tie{}3.2 (using
 361  @samp{--init-file=html32.pm} produces strict HTML@tie{}3.2 output;
 362 -@pxref{Invoking @command{texi2any}}):
 363 +@pxref{@command{texi2any}}):
 364
 365  @enumerate
 366  @item
 367 @@ -18778,7 +18777,7 @@
 368  @code{CASE_INSENSITIVE_FILENAMES}.
 369
 370  It is also possible to split at chapters or sections with
 371 -@option{--split} (@pxref{Invoking @command{texi2any}}).  In that case,
 372 +@option{--split} (@pxref{@command{texi2any}}).  In that case,
 373  the file names are constructed after the name of the node associated
 374  with the relevant sectioning command.  Also, unless
 375  @option{--no-node-files} is specified, a redirection file is output
 376 @@ -22392,8 +22391,7 @@
 377  this, you must run the @code{texindex} command after first running the
 378  @code{tex} typesetting command; and then you must run the @code{tex}
 379  command again.  Or else run the @code{texi2dvi} command which
 380 -automatically creates indices as needed (@pxref{Format with
 381 -@command{texi2dvi}}).
 382 +automatically creates indices as needed (@pxref{@command{texi2dvi}}).
 383
 384  Often, when you are writing a document, you want to typeset and print
 385  only part of a file to see what it will look like.  You can use the