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