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.1/doc/texinfo.txi.orig    2013-03-11 19:31:13.000000000 +0100
  47 +++ texinfo-5.1/doc/texinfo.txi 2013-06-24 19:07:23.441870590 +0200
  48 @@ -57,16 +57,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 @@ -576,8 +576,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 @@ -590,18 +590,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 @@ -634,7 +634,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 @@ -974,7 +974,7 @@
 117  @uref{http://tug.org/TUGboat/tb22-3/tb72beebe-pdf.pdf} have some
 118  background.  By default, Texinfo uses the @command{pdftex} program, a
 119  variant 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 @@ -2546,8 +2546,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 @@ -3067,7 +3066,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 @@ -3699,8 +3698,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 @@ -13688,7 +13687,7 @@
 156  extended @TeX{} programs @command{etex} (DVI output) and
 157  @command{pdftex} (PDF output), such as @TeX{} Live 2008.
 158  @command{texi2dvi} will use the extended @TeX{}s if they are available
 159 -(@pxref{Format with @t{texi2dvi}}).
 160 +(@pxref{@t{texi2dvi}}).
 161
 162  In September 2006, the W3C Internationalization Activity released a
 163  new recommendation for specifying languages:
 164 @@ -14962,8 +14961,8 @@
 165  some of the caveats are listed below.  Thus, if you get macro-related
 166  errors when producing the printed version of a manual, you might try
 167  expanding the macros with @command{makeinfo} by invoking
 168 -@command{texi2dvi} with the @samp{-E} option (@pxref{Format with
 169 -@t{texi2dvi}}).  Or, more reliably, eschew Texinfo macros altogether
 170 +@command{texi2dvi} with the @samp{-E} option (@pxref{@t{texi2dvi}}).
 171 +Or, more reliably, eschew Texinfo macros altogether
 172  and use a language designed for macro processing, such as M4
 173  (@pxref{External Macro Processors}).
 174
 175 @@ -15377,8 +15376,8 @@
 176
 177  @itemize @bullet
 178  @item
 179 -If you run @command{texi2dvi} or its variants (@pxref{Format with
 180 -@t{texi2dvi}}), you can pass @option{-E} and @command{texi2dvi}
 181 +If you run @command{texi2dvi} or its variants (@pxref{@t{texi2dvi}}),
 182 +you can pass @option{-E} and @command{texi2dvi}
 183  will run @command{makeinfo} first to expand macros and eliminate
 184  @samp{#line}.
 185
 186 @@ -15743,8 +15742,8 @@
 187
 188  @menu
 189  * Use @TeX{}::                     Use @TeX{} to format for hardcopy.
 190 -* Format with @t{tex}/@t{texindex}::    How to format with explicit shell commands.
 191 -* Format with @t{texi2dvi}::        A simpler way to format.
 192 +* @t{tex}/@t{texindex}::                How to format with explicit shell commands.
 193 +* @t{texi2dvi}::                    A simpler way to format.
 194  * Print with @t{lpr}::              How to print.
 195  * Within Emacs::                How to format and print from an Emacs shell.
 196  * Texinfo Mode Printing::       How to format and print in Texinfo mode.
 197 @@ -15757,7 +15756,7 @@
 198  * @t{@@pagesizes}::                  How to print with customized page sizes.
 199  * Cropmarks and Magnification:: How to print marks to indicate the size
 200                                   of pages and how to print scaled up output.
 201 -* PDF Output::                  Portable Document Format output.
 202 +* texi2pdf::                    Portable Document Format output.
 203  * Obtaining @TeX{}::               How to obtain @TeX{}.
 204  @end menu
 205
 206 @@ -15774,7 +15773,7 @@
 207  itself.
 208
 209
 210 -@node Format with @t{tex}/@t{texindex}
 211 +@node @t{tex}/@t{texindex}
 212  @section Format with @code{tex}/@code{texindex}
 213
 214  @cindex Shell formatting with @code{tex} and @code{texindex}
 215 @@ -15874,7 +15873,7 @@
 216
 217  @pindex texi2dvi
 218  Alternatively, it's a one-step process: run @code{texi2dvi}
 219 -(@pxref{Format with @t{texi2dvi}}).
 220 +(@pxref{@t{texi2dvi}}).
 221
 222  You need not run @code{texindex} each time after you run @code{tex}.  If
 223  you do not, on the next run, the @code{tex} formatting command will use
 224 @@ -15906,7 +15905,7 @@
 225  (@pxref{Pointer Validation}).
 226
 227
 228 -@node Format with @t{texi2dvi}
 229 +@node @t{texi2dvi}
 230  @section Format with @code{texi2dvi}
 231
 232  @pindex texi2dvi @r{(shell script)}
 233 @@ -15945,7 +15944,7 @@
 234  @opindex --pdf@r{, for @command{texi2dvi}}
 235  @pindex pdftexi2dvi
 236  With the @option{--pdf} option, @command{texi2dvi} produces PDF output
 237 -instead of DVI (@pxref{PDF Output}), by running @command{pdftex}
 238 +instead of DVI (@pxref{texi2pdf}), by running @command{pdftex}
 239  instead of @command{tex}.  Alternatively, the command
 240  @command{texi2pdf} is an abbreviation for running @samp{texi2dvi
 241  --pdf}.  The command @command{pdftexi2dvi} is also supported as a
 242 @@ -16551,7 +16550,7 @@
 243  @xref{@t{@@small@dots{}}}, for information about commands that make
 244  it easier to produce examples for a smaller manual.
 245
 246 -@xref{Format with @t{texi2dvi}}, and @ref{Preparing for @TeX{}},
 247 +@xref{@t{texi2dvi}}, and @ref{Preparing for @TeX{}},
 248  for other ways to format with @code{@@smallbook} that do not require
 249  changing the source file.
 250
 251 @@ -16581,7 +16580,7 @@
 252  @end group
 253  @end example
 254
 255 -@xref{Format with @t{texi2dvi}}, and @ref{Preparing for @TeX{}},
 256 +@xref{@t{texi2dvi}}, and @ref{Preparing for @TeX{}},
 257  for other ways to format for different paper sizes that do not require
 258  changing the source file.
 259
 260 @@ -16630,7 +16629,7 @@
 261  margins, you must define a new command in @file{texinfo.tex} or
 262  @file{texinfo.cnf}.
 263
 264 -@xref{Format with @t{texi2dvi}}, and @ref{Preparing for @TeX{}},
 265 +@xref{@t{texi2dvi}}, and @ref{Preparing for @TeX{}},
 266  for other ways to specify @code{@@pagesizes} that do not require
 267  changing the source file.
 268
 269 @@ -16698,7 +16697,7 @@
 270  magnifications.  Be prepared to experiment.
 271
 272
 273 -@node PDF Output
 274 +@node texi2pdf
 275  @section PDF Output
 276  @cindex PDF output
 277
 278 @@ -16706,7 +16705,7 @@
 279  The simplest way to generate PDF output from Texinfo source is to run
 280  the convenience script @command{texi2pdf} (or @command{pdftexi2dvi});
 281  this executes the @command{texi2dvi} script with the @option{--pdf}
 282 -option (@pxref{Format with @t{texi2dvi}}).  If for some reason you
 283 +option (@pxref{@t{texi2dvi}}).  If for some reason you
 284  want to process the document by hand, you can run the @command{pdftex}
 285  program instead of plain @command{tex}.  That is, run @samp{pdftex
 286  foo.texi} instead of @samp{tex foo.texi}.
 287 @@ -16790,12 +16789,12 @@
 288
 289  @menu
 290  * Reference Implementation::    @command{texi2any}: the reference implementation.
 291 -* Invoking @t{texi2any}::           Running the translator from a shell.
 292 +* @t{texi2any}::                    Running the translator from a shell.
 293  * @t{texi2any} Printed Output::     Calling @command{texi2dvi}.
 294  * Pointer Validation::          How to check that pointers point somewhere.
 295  * Customization Variables::     Configuring @command{texi2any}.
 296  * Internationalization of Document Strings:: Translating program-inserted text.
 297 -* Invoking @t{pod2texi}::           Translating Perl pod to Texinfo.
 298 +* @t{pod2texi}::                    Translating Perl pod to Texinfo.
 299  * @t{texi2html}::                   An ancestor of @command{texi2any}.
 300  @end menu
 301
 302 @@ -16856,10 +16855,10 @@
 303  @command{texi2any}.
 304
 305
 306 -@node Invoking @t{texi2any}
 307 +@node @t{texi2any}
 308  @section Invoking @command{texi2any}/@code{makeinfo} from a Shell
 309
 310 -@anchor{Invoking makeinfo}
 311 +@anchor{makeinfo}
 312  @pindex makeinfo
 313  @pindex texi2any
 314
 315 @@ -17383,8 +17383,8 @@
 316  requested.
 317
 318  The output format options for this are @option{--dvi},
 319 -@option{--dvipdf}, @option{--pdf}, and @option{--ps}.  @xref{Format
 320 -with @t{texi2dvi}}, for more details on these options and general
 321 +@option{--dvipdf}, @option{--pdf}, and @option{--ps}.  @xref{@t{texi2dvi}},
 322 +for more details on these options and general
 323  @command{texi2dvi} operation.  In addition, the @option{--verbose},
 324  @option{--silent}, and @option{--quiet} options are passed on if
 325  specified; the @option{-I} and @option{-o} options are likewise passed
 326 @@ -17554,7 +17553,7 @@
 327  @cindex Options, customization variables for
 328
 329  The following table gives the customization variables associated with
 330 -some command line options.  @xref{Invoking @t{texi2any}}, for the
 331 +some command line options.  @xref{@t{texi2any}}, for the
 332  meaning of the options.
 333
 334  @multitable @columnfractions 0.5 0.5
 335 @@ -17629,7 +17628,7 @@
 336  @itemx xml
 337  These correspond to the command-line options (and
 338  @code{TEXINFO_OUTPUT_FORMAT} environment variable values) of the same
 339 -name.  @xref{Invoking @t{texi2any}}.
 340 +name.  @xref{@t{texi2any}}.
 341
 342  @item debugcount
 343  Instead of generating a regular output format, output the count of
 344 @@ -18432,11 +18431,11 @@
 345  appropriately in many languages.
 346
 347
 348 -@node Invoking @t{pod2texi}
 349 +@node @t{pod2texi}
 350  @section Invoking @t{pod2texi}:
 351
 352  @pindex pod2texi
 353 -@cindex Invoking @code{pod2texi}
 354 +@cindex @code{pod2texi}
 355  @cindex POD, converting to Texinfo
 356  @cindex Perl POD, converting to Texinfo
 357
 358 @@ -18884,7 +18883,7 @@
 359                                   located in other directories.
 360  * Installing Dir Entries::      How to specify what menu entry to add
 361                                   to the Info directory.
 362 -* Invoking @t{install-info}::       @code{install-info} options.
 363 +* @t{install-info}::                @code{install-info} options.
 364  @end menu
 365
 366
 367 @@ -19122,7 +19121,7 @@
 368  @@dircategory Texinfo documentation system
 369  @@direntry
 370  * Texinfo: (texinfo).           The GNU documentation format.
 371 -* install-info: (texinfo)Invoking install-info. @dots{}
 372 +* install-info: (texinfo)install-info. @dots{}
 373  @dots{}
 374  @@end direntry
 375  @end smallexample
 376 @@ -19133,7 +19132,7 @@
 377  INFO-DIR-SECTION Texinfo documentation system
 378  START-INFO-DIR-ENTRY
 379  * Texinfo: (texinfo).           The GNU documentation format.
 380 -* install-info: (texinfo)Invoking install-info. @dots{}
 381 +* install-info: (texinfo)install-info. @dots{}
 382  @dots{}
 383  END-INFO-DIR-ENTRY
 384  @end smallexample
 385 @@ -19155,7 +19154,7 @@
 386  most others.  Description for individual utilities best start in
 387  column 48, where possible.  For more information about formatting see
 388  the @samp{--calign}, @samp{--align}, and @samp{--max-width} options in
 389 -@ref{Invoking @t{install-info}}.
 390 +@ref{@t{install-info}}.
 391
 392  If you use @code{@@dircategory} more than once in the Texinfo source,
 393  each usage specifies the `current' category; any subsequent
 394 @@ -19190,7 +19189,7 @@
 395  traditional @command{man} system.
 396
 397
 398 -@node Invoking @t{install-info}
 399 +@node @t{install-info}
 400  @subsection Invoking @command{install-info}
 401
 402  @pindex install-info
 403 @@ -19481,7 +19480,7 @@
 404  (@code{thead}, @code{abbr}, @code{acronym}).
 405
 406  Using @samp{--init-file=html32.pm} produces strict HTML@tie{}3.2
 407 -output (@pxref{Invoking @t{texi2any}}).
 408 +output (@pxref{@t{texi2any}}).
 409
 410  Please report output from an error-free run of @code{makeinfo} which
 411  has browser portability problems as a bug (@pxref{Reporting Bugs}).
 412 @@ -19512,7 +19511,7 @@
 413  @code{CASE_INSENSITIVE_FILENAMES}.
 414
 415  It is also possible to split at chapters or sections with
 416 -@option{--split} (@pxref{Invoking @t{texi2any}}).  In that case,
 417 +@option{--split} (@pxref{@t{texi2any}}).  In that case,
 418  the file names are constructed after the name of the node associated
 419  with the relevant sectioning command.  Also, unless
 420  @option{--no-node-files} is specified, a redirection file is output