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