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-5.1/doc/info.texi.orig      2013-06-24 18:51:07.731911536 +0200
  16 +++ texinfo-5.1/doc/info.texi   2013-06-24 18:53:43.138571681 +0200
  17 @@ -36,9 +36,9 @@
  18  @end quotation
  19  @end copying
  20
  21 -@dircategory Texinfo documentation system
  22 +@dircategory Texinfo documentation system:
  23  @direntry
  24 -* Info: (info).                 How to use the documentation browsing system.
  25 +* Info: (info).                                How to use the documentation browsing system
  26  @end direntry
  27
  28  @titlepage
  29 --- texinfo-6.0/doc/texinfo.texi.orig   2015-06-26 13:55:13.000000000 +0200
  30 +++ texinfo-6.0/doc/texinfo.texi        2015-07-17 21:13:40.433503285 +0200
  31 @@ -52,16 +52,16 @@
  32  @end quotation
  33  @end copying
  34
  35 -@dircategory Texinfo documentation system
  36 +@dircategory Texinfo documentation system:
  37  @direntry
  38 -* Texinfo: (texinfo).           The GNU documentation format.
  39 -* install-info: (texinfo)Invoking install-info. Update info/dir entries.
  40 -* makeinfo: (texinfo)Invoking makeinfo.         Translate Texinfo source.
  41 -* pod2texi: (pod2texi)Invoking pod2texi.        Translate Perl POD to Texinfo.
  42 -* texi2dvi: (texinfo)Format with texi2dvi.      Print Texinfo documents.
  43 -* texi2pdf: (texinfo)PDF Output.                PDF output for Texinfo.
  44 -* pdftexi2dvi: (texinfo)PDF Output.             PDF output for Texinfo.
  45 -* texindex: (texinfo)Format with tex/texindex.  Sort Texinfo index files.
  46 +* Texinfo: (texinfo).                  The GNU documentation format
  47 +* install-info: (texinfo)install-info. Update info/dir entries
  48 +* makeinfo: (texinfo)makeinfo.         Translate Texinfo source
  49 +* pod2texi: (pod2texi)pod2texi.                Translate Perl POD to Texinfo.
  50 +* texi2dvi: (texinfo)texi2dvi.         Print Texinfo documents
  51 +* texi2pdf: (texinfo)texi2pdf.         PDF output for Texinfo
  52 +* pdftexi2dvi: (texinfo)pdftexi2dvi.   PDF output for Texinfo
  53 +* texindex: (texinfo)tex/texindex.     Sort Texinfo index files
  54  @end direntry
  55
  56  @c Set smallbook if printing in smallbook format so the example of the
  57 @@ -570,8 +570,8 @@
  58  Formatting and Printing Hardcopy
  59
  60  * Use @TeX{}::                     Use @TeX{} to format for hardcopy.
  61 -* Format with @t{texi2dvi}::        The simplest way to format.
  62 -* Format with @t{tex}/@t{texindex}::    Formatting with explicit shell commands.
  63 +* @t{texi2dvi}::                    The simplest way to format.
  64 +* @t{tex}/@t{texindex}::                Formatting with explicit shell commands.
  65  * Print with @t{lpr}::              How to print.
  66  * Within Emacs::                Printing from an Emacs shell.
  67  * Texinfo Mode Printing::       How to format and print in Texinfo mode.
  68 @@ -584,7 +584,7 @@
  69  * @t{@@pagesizes}::                  How to print with customized page sizes.
  70  * Cropmarks and Magnification:: How to print marks to indicate the size
  71                                   of pages and how to print scaled up output.
  72 -* PDF Output::                  Portable Document Format output.
  73 +* texi2pdf::                    Portable Document Format output.
  74  * Obtaining @TeX{}::               How to obtain @TeX{}.
  75
  76  Format with @t{tex}/@t{texindex}
  77 @@ -595,12 +595,12 @@
  78  @code{texi2any}: The Generic Translator for Texinfo
  79
  80  * Reference Implementation::    @command{texi2any}: the reference implementation.
  81 -* Invoking @t{texi2any}::           Running the translator from a shell.
  82 +* @t{texi2any}::                    Running the translator from a shell.
  83  * @t{texi2any} Printed Output::     Calling @command{texi2dvi}.
  84  * Pointer Validation::          How to check that pointers point somewhere.
  85  * Customization Variables::     Configuring @command{texi2any}.
  86  * Internationalization of Document Strings:: Translating program-inserted text.
  87 -* Invoking @t{pod2texi}::           Translating Perl pod to Texinfo.
  88 +* @t{pod2texi}::                    Translating Perl pod to Texinfo.
  89  * @t{texi2html}::                   An ancestor of @command{texi2any}.
  90
  91  Customization Variables
  92 @@ -633,7 +633,7 @@
  93                                   located in other directories.
  94  * Installing Dir Entries::      How to specify what menu entry to add
  95                                   to the Info directory.
  96 -* Invoking @t{install-info}::       @code{install-info} options.
  97 +* @t{install-info}::                 @code{install-info} options.
  98
  99  Generating HTML
 100
 101 @@ -977,7 +977,7 @@
 102  @uref{http://tug.org/TUGboat/tb22-3/tb72beebe-pdf.pdf} have some
 103  background.  By default, Texinfo uses the @command{pdftex} program, an
 104  extension of @TeX{}, to output PDF; see
 105 -@uref{http://tug.org/applications/pdftex}.  @xref{PDF Output}.
 106 +@uref{http://tug.org/applications/pdftex}.  @xref{texi2pdf}.
 107
 108  @item Docbook
 109  @cindex Docbook output, overview
 110 @@ -2572,8 +2572,7 @@
 111  this, you must run the @code{texindex} command after first running the
 112  @code{tex} typesetting command; and then you must run the @code{tex}
 113  command again.  Or else run the @code{texi2dvi} command which
 114 -automatically creates indices as needed (@pxref{Format with
 115 -@t{texi2dvi}}).
 116 +automatically creates indices as needed (@pxref{@t{texi2dvi}}).
 117
 118  Often, when you are writing a document, you want to typeset and print
 119  only part of a file to see what it will look like.  You can use the
 120 @@ -3093,7 +3092,7 @@
 121  when generating Info, etc.  The @code{\input} line is still ignored in
 122  this processing, as well as leading blank lines.
 123
 124 -See also the @option{--output} option in @ref{Invoking @t{texi2any}}.
 125 +See also the @option{--output} option in @ref{@t{texi2any}}.
 126
 127
 128  @node @t{@@settitle}
 129 @@ -3726,8 +3725,8 @@
 130
 131  You need to include the @code{@@set@dots{}contentsaftertitlepage}
 132  commands early in the document (just after @code{@@setfilename}, for
 133 -example).  We recommend using @command{texi2dvi} (@pxref{Format with
 134 -@t{texi2dvi}}) to specify this without altering the source file at
 135 +example).  We recommend using @command{texi2dvi} (@pxref{@t{texi2dvi}})
 136 +to specify this without altering the source file at
 137  all.  For example:
 138
 139  @example
 140 @@ -14035,8 +14034,7 @@
 141  itself, but will usually be the case for up-to-date distributions of
 142  the extended @TeX{} programs @command{etex} (DVI output) and
 143  @command{pdftex} (PDF output).  @command{texi2dvi} will use the
 144 -extended @TeX{}s if they are available (@pxref{Format with
 145 -@t{texi2dvi}}).
 146 +extended @TeX{}s if they are available (@pxref{@t{texi2dvi}}).
 147
 148  In September 2006, the W3C Internationalization Activity released a
 149  new recommendation for specifying languages:
 150 @@ -15378,8 +15376,8 @@
 151  some of the caveats are listed below.  Thus, if you get macro-related
 152  errors when producing the printed version of a manual, you might try
 153  expanding the macros with @command{makeinfo} by invoking
 154 -@command{texi2dvi} with the @samp{-E} option (@pxref{Format with
 155 -@t{texi2dvi}}).  Or, more reliably, eschew Texinfo macros altogether
 156 +@command{texi2dvi} with the @samp{-E} option (@pxref{@t{texi2dvi}}).
 157 +Or, more reliably, eschew Texinfo macros altogether
 158  and use a language designed for macro processing, such as M4
 159  (@pxref{External Macro Processors}).
 160
 161 @@ -15775,8 +15773,8 @@
 162
 163  @itemize @bullet
 164  @item
 165 -If you run @command{texi2dvi} or its variants (@pxref{Format with
 166 -@t{texi2dvi}}), you can pass @option{-E} and @command{texi2dvi}
 167 +If you run @command{texi2dvi} or its variants (@pxref{@t{texi2dvi}}),
 168 +you can pass @option{-E} and @command{texi2dvi}
 169  will run @command{makeinfo} first to expand macros and eliminate
 170  @samp{#line}.
 171
 172 @@ -16140,8 +16138,8 @@
 173
 174  @menu
 175  * Use @TeX{}::                     Use @TeX{} to format for hardcopy.
 176 -* Format with @t{texi2dvi}::        The simplest way to format.
 177 -* Format with @t{tex}/@t{texindex}::    Formatting with explicit shell commands.
 178 +* @t{texi2dvi}::                    The simplest way to format.
 179 +* @t{tex}/@t{texindex}::                Formatting with explicit shell commands.
 180  * Print with @t{lpr}::              How to print.
 181  * Within Emacs::                How to format and print from an Emacs shell.
 182  * Texinfo Mode Printing::       How to format and print in Texinfo mode.
 183 @@ -16154,7 +16152,7 @@
 184  * @t{@@pagesizes}::                  How to print with customized page sizes.
 185  * Cropmarks and Magnification:: How to print marks to indicate the size
 186                                   of pages and how to print scaled up output.
 187 -* PDF Output::                  Portable Document Format output.
 188 +* texi2pdf::                    Portable Document Format output.
 189  * Obtaining @TeX{}::               How to obtain @TeX{}.
 190  @end menu
 191
 192 @@ -16171,7 +16169,7 @@
 193  in itself.
 194
 195
 196 -@node Format with @t{texi2dvi}
 197 +@node @t{texi2dvi}
 198  @section Format with @code{texi2dvi}
 199
 200  @pindex texi2dvi @r{(shell script)}
 201 @@ -16209,7 +16207,7 @@
 202  @opindex --pdf@r{, for @command{texi2dvi}}
 203  @pindex pdftexi2dvi
 204  With the @option{--pdf} option, @command{texi2dvi} produces PDF output
 205 -instead of DVI (@pxref{PDF Output}), by running @command{pdftex}
 206 +instead of DVI (@pxref{texi2pdf}), by running @command{pdftex}
 207  instead of @command{tex}.  Alternatively, the command
 208  @command{texi2pdf} is an abbreviation for running @samp{texi2dvi
 209  --pdf}.  The command @command{pdftexi2dvi} is also provided as a
 210 @@ -16263,7 +16261,7 @@
 211  For a list of all the options, run @samp{texi2dvi --help}.
 212
 213
 214 -@node Format with @t{tex}/@t{texindex}
 215 +@node @t{tex}/@t{texindex}
 216  @section Format with @code{tex}/@code{texindex}
 217
 218  @cindex Shell formatting with @code{tex} and @code{texindex}
 219 @@ -16479,7 +16477,7 @@
 220
 221  For example, the following commands will (probably) suffice to sort
 222  the indices, format, and print this manual using the @code{texi2dvi}
 223 -shell script (@pxref{Format with @t{texi2dvi}}).
 224 +shell script (@pxref{@t{texi2dvi}}).
 225
 226  @example
 227  @group
 228 @@ -16954,7 +16952,7 @@
 229  @xref{@t{@@small@dots{}}}, for information about commands that make
 230  it easier to produce examples for a smaller manual.
 231
 232 -@xref{Format with @t{texi2dvi}}, and @ref{Preparing for @TeX{}},
 233 +@xref{@t{texi2dvi}}, and @ref{Preparing for @TeX{}},
 234  for other ways to format with @code{@@smallbook} that do not require
 235  changing the source file.
 236
 237 @@ -16985,7 +16983,7 @@
 238  @end group
 239  @end example
 240
 241 -@xref{Format with @t{texi2dvi}}, and @ref{Preparing for @TeX{}},
 242 +@xref{@t{texi2dvi}}, and @ref{Preparing for @TeX{}},
 243  for other ways to format for different paper sizes that do not require
 244  changing the source file.
 245
 246 @@ -17034,7 +17032,7 @@
 247  margins, you must define a new command in @file{texinfo.tex} or
 248  @file{texinfo.cnf}.
 249
 250 -@xref{Format with @t{texi2dvi}}, and @ref{Preparing for @TeX{}},
 251 +@xref{@t{texi2dvi}}, and @ref{Preparing for @TeX{}},
 252  for other ways to specify @code{@@pagesizes} that do not require
 253  changing the source file.
 254
 255 @@ -17100,7 +17098,7 @@
 256  magnifications.  Be prepared to experiment.
 257
 258
 259 -@node PDF Output
 260 +@node texi2pdf
 261  @section PDF Output
 262  @cindex PDF output
 263  @cindex Output, in PDF
 264 @@ -17109,7 +17107,7 @@
 265  The simplest way to generate PDF output from Texinfo source is to run
 266  the convenience script @command{texi2pdf} (or @command{pdftexi2dvi});
 267  this executes the @command{texi2dvi} script with the @option{--pdf}
 268 -option (@pxref{Format with @t{texi2dvi}}).  If for some reason you
 269 +option (@pxref{@t{texi2dvi}}).  If for some reason you
 270  want to process the document by hand, you can run the @command{pdftex}
 271  program instead of plain @command{tex}.  That is, run @samp{pdftex
 272  foo.texi} instead of @samp{tex foo.texi}.
 273 @@ -17196,12 +17194,12 @@
 274
 275  @menu
 276  * Reference Implementation::    @command{texi2any}: the reference implementation.
 277 -* Invoking @t{texi2any}::           Running the translator from a shell.
 278 +* @t{texi2any}::                    Running the translator from a shell.
 279  * @t{texi2any} Printed Output::     Calling @command{texi2dvi}.
 280  * Pointer Validation::          How to check that pointers point somewhere.
 281  * Customization Variables::     Configuring @command{texi2any}.
 282  * Internationalization of Document Strings:: Translating program-inserted text.
 283 -* Invoking @t{pod2texi}::           Translating Perl pod to Texinfo.
 284 +* @t{pod2texi}::                    Translating Perl pod to Texinfo.
 285  * @t{texi2html}::                   An ancestor of @command{texi2any}.
 286  @end menu
 287
 288 @@ -17262,10 +17260,10 @@
 289  @command{texi2any}.
 290
 291
 292 -@node Invoking @t{texi2any}
 293 +@node @t{texi2any}
 294  @section Invoking @command{texi2any}/@code{makeinfo} from a Shell
 295
 296 -@anchor{Invoking makeinfo}
 297 +@anchor{makeinfo}
 298  @pindex makeinfo
 299  @pindex texi2any
 300
 301 @@ -17804,8 +17802,8 @@
 302  @command{texi2dvi} directly.
 303
 304  The output format options for this are @option{--dvi},
 305 -@option{--dvipdf}, @option{--pdf}, and @option{--ps}.  @xref{Format
 306 -with @t{texi2dvi}}, for more details on these options and general
 307 +@option{--dvipdf}, @option{--pdf}, and @option{--ps}.  @xref{@t{texi2dvi}},
 308 +for more details on these options and general
 309  @command{texi2dvi} operation.  In addition, the @option{--verbose},
 310  @option{--silent}, and @option{--quiet} options are passed on if
 311  specified; the @option{-I} and @option{-o} options are likewise passed
 312 @@ -17979,7 +17977,7 @@
 313  @cindex Options, customization variables for
 314
 315  The following table gives the customization variables associated with
 316 -some command line options.  @xref{Invoking @t{texi2any}}, for the
 317 +some command line options.  @xref{@t{texi2any}}, for the
 318  meaning of the options.
 319
 320  @multitable @columnfractions 0.5 0.5
 321 @@ -18054,7 +18052,7 @@
 322  @itemx xml
 323  These correspond to the command-line options (and
 324  @code{TEXINFO_OUTPUT_FORMAT} environment variable values) of the same
 325 -name.  @xref{Invoking @t{texi2any}}.
 326 +name.  @xref{@t{texi2any}}.
 327
 328  @item debugcount
 329  Instead of generating a regular output format, output the count of
 330 @@ -18702,7 +18700,7 @@
 331
 332  The following transformations are currently supported (many are used
 333  in the @code{pod2texi} utility distributed with Texinfo;
 334 -@pxref{Invoking @t{pod2texi}}):
 335 +@pxref{@t{pod2texi}}):
 336
 337  @ftable @samp
 338  @item complete_tree_nodes_menus
 339 @@ -18877,7 +18875,7 @@
 340  appropriately in many languages.
 341
 342
 343 -@node Invoking @t{pod2texi}
 344 +@node @t{pod2texi}
 345  @section Invoking @t{pod2texi}: Convert POD to Texinfo
 346
 347  @pindex pod2texi
 348 @@ -19329,7 +19327,7 @@
 349                                   located in other directories.
 350  * Installing Dir Entries::      How to specify what menu entry to add
 351                                   to the Info directory.
 352 -* Invoking @t{install-info}::       @code{install-info} options.
 353 +* @t{install-info}::                @code{install-info} options.
 354  @end menu
 355
 356
 357 @@ -19567,7 +19565,7 @@
 358  @@dircategory Texinfo documentation system
 359  @@direntry
 360  * Texinfo: (texinfo).           The GNU documentation format.
 361 -* install-info: (texinfo)Invoking install-info. @dots{}
 362 +* install-info: (texinfo)install-info. @dots{}
 363  @dots{}
 364  @@end direntry
 365  @end smallexample
 366 @@ -19578,7 +19576,7 @@
 367  INFO-DIR-SECTION Texinfo documentation system
 368  START-INFO-DIR-ENTRY
 369  * Texinfo: (texinfo).           The GNU documentation format.
 370 -* install-info: (texinfo)Invoking install-info. @dots{}
 371 +* install-info: (texinfo)install-info. @dots{}
 372  @dots{}
 373  END-INFO-DIR-ENTRY
 374  @end smallexample
 375 @@ -19600,7 +19598,7 @@
 376  most others.  Description for individual utilities best start in
 377  column 48, where possible.  For more information about formatting see
 378  the @samp{--calign}, @samp{--align}, and @samp{--max-width} options in
 379 -@ref{Invoking @t{install-info}}.
 380 +@ref{@t{install-info}}.
 381
 382  If you use @code{@@dircategory} more than once in the Texinfo source,
 383  each usage specifies the `current' category; any subsequent
 384 @@ -19635,7 +19633,7 @@
 385  traditional @command{man} system.
 386
 387
 388 -@node Invoking @t{install-info}
 389 +@node @t{install-info}
 390  @subsection Invoking @command{install-info}
 391
 392  @pindex install-info
 393 @@ -19901,7 +19901,7 @@
 394  @pindex html32.pm
 395  Some known exceptions to HTML@tie{}3.2 (using
 396  @samp{--init-file=html32.pm} produces strict HTML@tie{}3.2 output;
 397 -@pxref{Invoking @t{texi2any}}):
 398 +@pxref{@t{texi2any}}):
 399
 400  @enumerate
 401  @item
 402 @@ -20005,7 +20003,7 @@
 403  @code{CASE_INSENSITIVE_FILENAMES}.
 404
 405  It is also possible to split at chapters or sections with
 406 -@option{--split} (@pxref{Invoking @t{texi2any}}).  In that case,
 407 +@option{--split} (@pxref{@t{texi2any}}).  In that case,
 408  the file names are constructed after the name of the node associated
 409  with the relevant sectioning command.  Also, unless
 410  @option{--no-node-files} is specified, a redirection file is output