texinfo-info.patch

   1 --- texinfo-4.7/doc/info-stnd.texi.orig 2004-03-24 02:41:06.000000000 +0100
   2 +++ texinfo-4.7/doc/info-stnd.texi      2004-04-12 13:07:58.150558008 +0200
   3 @@ -35,10 +35,10 @@
   4  @end quotation
   5  @end copying
   6
   7 -@dircategory Texinfo documentation system
   8 +@dircategory Texinfo documentation system:
   9  @direntry
  10 -* info standalone: (info-stnd).            Read Info documents without Emacs.
  11 -* infokey: (info-stnd)Invoking infokey.    Compile Info customizations.
  12 +* info standalone: (info-stnd).                Read Info documents without Emacs
  13 +* infokey: (info-stnd)infokey.         Compile Info customizations
  14  @end direntry
  15
  16  @titlepage
  17 @@ -1963,12 +1963,12 @@
  18  textual source file using the @code{infokey} command.
  19
  20  @menu
  21 -* Invoking infokey::
  22 +* infokey::
  23  * infokey source format::
  24  @end menu
  25
  26
  27 -@node Invoking infokey
  28 +@node infokey
  29  @section Invoking @command{infokey}
  30
  31  @cindex invoking infokey
  32 --- texinfo-4.7/doc/info.texi.orig      2004-04-06 10:21:35.000000000 +0200
  33 +++ texinfo-4.7/doc/info.texi   2004-04-12 13:08:41.859913176 +0200
  34 @@ -37,9 +37,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).                                The documentation browsing system
  43  @end direntry
  44
  45  @titlepage
  46 --- texinfo-4.8/doc/texinfo.txi.orig    2004-12-29 16:06:41.000000000 +0100
  47 +++ texinfo-4.8/doc/texinfo.txi 2005-01-08 00:19:43.541783216 +0100
  48 @@ -54,14 +54,14 @@
  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 -* texi2dvi: (texinfo)Format with texi2dvi.      Print Texinfo documents.
  58 -* texi2pdf: (texinfo)PDF Output.                PDF output for Texinfo.
  59 -* texindex: (texinfo)Format with tex/texindex.  Sort Texinfo index files.
  60 -* makeinfo: (texinfo)Invoking makeinfo.         Translate Texinfo source.
  61 +* Texinfo: (texinfo).                  The GNU documentation format
  62 +* install-info: (texinfo)install-info. Update info/dir entries
  63 +* texi2dvi: (texinfo)texi2dvi.         Print Texinfo documents
  64 +* texi2pdf: (texinfo)texi2pdf.         PDF output for Texinfo
  65 +* texindex: (texinfo)texindex.         Sort Texinfo index files
  66 +* makeinfo: (texinfo)makeinfo.         Translate Texinfo source
  67  @end direntry
  68
  69  @c Before release, run C-u C-c C-u C-a (texinfo-all-menus-update with a
  70 @@ -556,8 +556,8 @@
  71  Formatting and Printing Hardcopy
  72
  73  * Use TeX::                     Use @TeX{} to format for hardcopy.
  74 -* Format with tex/texindex::    How to format with explicit shell commands.
  75 -* Format with texi2dvi::        A simpler way to format.
  76 +* texindex::                    How to format with explicit shell commands.
  77 +* texi2dvi::                    A simpler way to format.
  78  * Print with lpr::              How to print.
  79  * Within Emacs::                How to format and print from an Emacs shell.
  80  * Texinfo Mode Printing::       How to format and print in Texinfo mode.
  81 @@ -570,7 +570,7 @@
  82  * pagesizes::                   How to print with customized page sizes.
  83  * Cropmarks and Magnification:: How to print marks to indicate the size
  84                                   of pages and how to print scaled up output.
  85 -* PDF Output::                  Portable Document Format output.
  86 +* texi2pdf::                    Portable Document Format output.
  87  * Obtaining TeX::               How to Obtain @TeX{}.
  88
  89  Creating and Installing Info Files
  90 @@ -581,7 +581,7 @@
  91  Creating an Info File
  92
  93  * makeinfo advantages::         @code{makeinfo} provides better error checking.
  94 -* Invoking makeinfo::           How to run @code{makeinfo} from a shell.
  95 +* makeinfo::                    How to run @code{makeinfo} from a shell.
  96  * makeinfo options::            Specify fill-column and other options.
  97  * Pointer Validation::          How to check that pointers point somewhere.
  98  * makeinfo in Emacs::           How to run @code{makeinfo} from Emacs.
  99 @@ -600,7 +600,7 @@
 100                                   located in other directories.
 101  * Installing Dir Entries::      How to specify what menu entry to add
 102                                   to the Info directory.
 103 -* Invoking install-info::       @code{install-info} options.
 104 +* install-info::                @code{install-info} options.
 105
 106  Generating HTML
 107
 108 @@ -906,7 +906,7 @@
 109  viewable, among other design goals; for a discussion, see
 110  @uref{http://tug.org/TUGboat/Articles/tb22-3/tb72beebeI.pdf}.  Texinfo
 111  uses the @command{pdftex} program, a variant of @TeX{}, to output PDF;
 112 -see @uref{http://tug.org/applications/pdftex}.  @xref{PDF Output}.
 113 +see @uref{http://tug.org/applications/pdftex}.  @xref{texi2pdf}.
 114
 115  @item XML
 116  @cindex XML output
 117 @@ -2438,7 +2438,7 @@
 118  you must run the @code{texindex} command after first running the
 119  @code{tex} typesetting command; and then you must run the @code{tex}
 120  command again.  Or else run the @code{texi2dvi} command which
 121 -automatically creates indices as needed (@pxref{Format with texi2dvi}).
 122 +automatically creates indices as needed (@pxref{texi2dvi}).
 123
 124  Often, when you are writing a document, you want to typeset and print
 125  only part of a file to see what it will look like.  You can use the
 126 @@ -3645,8 +3645,8 @@
 127
 128  You need to include the @code{@@set@dots{}contentsaftertitlepage}
 129  commands early in the document (just after @code{@@setfilename}, for
 130 -example).  We recommend using @command{texi2dvi} (@pxref{Format with
 131 -texi2dvi}) to specify this without altering the source file at all.  For
 132 +example).  We recommend using @command{texi2dvi} (@pxref{texi2dvi})
 133 +to specify this without altering the source file at all.  For
 134  example:
 135  @example
 136  texi2dvi --texinfo=@@setcontentsaftertitlepage foo.texi
 137 @@ -13637,7 +13637,7 @@
 138  problems with @TeX{}.  If you get macro-related errors when producing
 139  the printed version of a manual, try expanding the macros with
 140  @command{makeinfo} by invoking @command{texi2dvi} with the @samp{-E}
 141 -option (@pxref{Format with texi2dvi}).
 142 +option (@pxref{texi2dvi}).
 143
 144  @itemize @bullet
 145  @item
 146 @@ -13906,8 +13906,8 @@
 147
 148  @menu
 149  * Use TeX::                     Use @TeX{} to format for hardcopy.
 150 -* Format with tex/texindex::    How to format with explicit shell commands.
 151 -* Format with texi2dvi::        A simpler way to format.
 152 +* texindex::                    How to format with explicit shell commands.
 153 +* texi2dvi::                    A simpler way to format.
 154  * Print with lpr::              How to print.
 155  * Within Emacs::                How to format and print from an Emacs shell.
 156  * Texinfo Mode Printing::       How to format and print in Texinfo mode.
 157 @@ -13920,7 +13920,7 @@
 158  * pagesizes::                   How to print with customized page sizes.
 159  * Cropmarks and Magnification:: How to print marks to indicate the size
 160                                   of pages and how to print scaled up output.
 161 -* PDF Output::                  Portable Document Format output.
 162 +* texi2pdf::                    Portable Document Format output.
 163  * Obtaining TeX::               How to Obtain @TeX{}.
 164  @end menu
 165
 166 @@ -13939,7 +13939,7 @@
 167  File}).
 168
 169
 170 -@node Format with tex/texindex
 171 +@node texindex
 172  @section Format with @code{tex} and @code{texindex}
 173  @cindex Shell formatting with @code{tex} and @code{texindex}
 174  @cindex Formatting with @code{tex} and @code{texindex}
 175 @@ -14036,7 +14036,7 @@
 176
 177  @pindex texi2dvi
 178  Alternatively, it's a one-step process: run @code{texi2dvi}
 179 -(@pxref{Format with texi2dvi}).
 180 +(@pxref{texi2dvi}).
 181
 182  You need not run @code{texindex} each time after you run @code{tex}.  If
 183  you do not, on the next run, the @code{tex} formatting command will use
 184 @@ -14068,7 +14068,7 @@
 185  (@pxref{Pointer Validation}).
 186
 187
 188 -@node Format with texi2dvi
 189 +@node texi2dvi
 190  @section Format with @code{texi2dvi}
 191  @pindex texi2dvi @r{(shell script)}
 192
 193 @@ -14103,7 +14103,7 @@
 194  @pxref{Preparing for TeX,,Preparing for @TeX{}}).
 195
 196  With the @option{--pdf} option, @command{texi2dvi} produces PDF output
 197 -instead of DVI (@pxref{PDF Output}), by running @command{pdftex}
 198 +instead of DVI (@pxref{texi2pdf}), by running @command{pdftex}
 199  instead of @command{tex}.  Alternatively, the command
 200  @command{texi2pdf} is an abbreviation for running @samp{texi2dvi --pdf}.
 201
 202 @@ -14631,7 +14631,7 @@
 203  @xref{small}, for information about
 204  commands that make it easier to produce examples for a smaller manual.
 205
 206 -@xref{Format with texi2dvi}, and @ref{Preparing for TeX,,Preparing for
 207 +@xref{texi2dvi}, and @ref{Preparing for TeX,,Preparing for
 208  @TeX{}}, for other ways to format with @code{@@smallbook} that do not
 209  require changing the source file.
 210
 211 @@ -14661,7 +14661,7 @@
 212  @end group
 213  @end example
 214
 215 -@xref{Format with texi2dvi}, and @ref{Preparing for TeX,,Preparing for
 216 +@xref{texi2dvi}, and @ref{Preparing for TeX,,Preparing for
 217  @TeX{}}, for other ways to format for different paper sizes that do not
 218  require changing the source file.
 219
 220 @@ -14707,7 +14707,7 @@
 221  margins, you must define a new command in @file{texinfo.tex} (or
 222  @file{texinfo.cnf}, @pxref{Preparing for TeX,,Preparing for @TeX{}}).
 223
 224 -@xref{Format with texi2dvi}, and @ref{Preparing for TeX,,Preparing for
 225 +@xref{texi2dvi}, and @ref{Preparing for TeX,,Preparing for
 226  @TeX{}}, for other ways to specify @code{@@pagesizes} that do not
 227  require changing the source file.
 228
 229 @@ -14776,7 +14776,7 @@
 230  magnifications.  Be prepared to experiment.
 231
 232
 233 -@node PDF Output
 234 +@node texi2pdf
 235  @section PDF Output
 236  @cindex PDF output
 237
 238 @@ -14784,7 +14784,7 @@
 239  The simplest way to generate PDF output from Texinfo source is to run
 240  the convenience script @command{texi2pdf}; this simply executes the
 241  @command{texi2dvi} script with the @option{--pdf} option
 242 -(@pxref{Format with texi2dvi}).  If for some reason you want to
 243 +(@pxref{texi2dvi}).  If for some reason you want to
 244  process by hand, simply run the @command{pdftex} program instead of
 245  plain @command{tex}.  That is, run @samp{pdftex foo.texi} instead of
 246  @samp{tex foo.texi}.
 247 @@ -14888,7 +14888,7 @@
 248
 249  @menu
 250  * makeinfo advantages::         @code{makeinfo} provides better error checking.
 251 -* Invoking makeinfo::           How to run @code{makeinfo} from a shell.
 252 +* makeinfo::                    How to run @code{makeinfo} from a shell.
 253  * makeinfo options::            Specify fill-column and other options.
 254  * Pointer Validation::          How to check that pointers point somewhere.
 255  * makeinfo in Emacs::           How to run @code{makeinfo} from Emacs.
 256 @@ -14920,7 +14920,7 @@
 257  @code{makeinfo}.
 258
 259
 260 -@node Invoking makeinfo
 261 +@node makeinfo
 262  @subsection Running @code{makeinfo} from a Shell
 263  @pindex makeinfo
 264
 265 @@ -15620,7 +15620,7 @@
 266                                   located in other directories.
 267  * Installing Dir Entries::      How to specify what menu entry to add
 268                                   to the Info directory.
 269 -* Invoking install-info::       @code{install-info} options.
 270 +* install-info::                @code{install-info} options.
 271  @end menu
 272
 273
 274 @@ -15926,7 +15926,7 @@
 275  traditional @command{man} system.
 276
 277
 278 -@node Invoking install-info
 279 +@node install-info
 280  @subsection Invoking @command{install-info}
 281  @pindex install-info
 282
 283 @@ -16442,7 +16442,7 @@
 284
 285  In standard Texinfo, node names may not contain @@-commands.
 286  @command{makeinfo} has an option @option{--commands-in-node-names}
 287 -which partially supports it (@pxref{Invoking makeinfo}), but it is not
 288 +which partially supports it (@pxref{makeinfo}), but it is not
 289  robust and not recommended.
 290
 291  Thus, @command{makeinfo} also does not fully implement this part of