texinfo-info.patch

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