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.7/doc/texinfo.txi.orig    2004-04-09 23:30:07.000000000 +0200
  47 +++ texinfo-4.7/doc/texinfo.txi 2004-04-12 13:23:06.957398368 +0200
  48 @@ -54,13 +54,13 @@
  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 -* texindex: (texinfo)Format with tex/texindex.  Sort Texinfo index files.
  59 -* makeinfo: (texinfo)Invoking makeinfo.         Translate Texinfo source.
  60 +* Texinfo: (texinfo).                  The GNU documentation format
  61 +* install-info: (texinfo)install-info. Update info/dir entries
  62 +* texi2dvi: (texinfo)texi2dvi.         Print Texinfo documents
  63 +* texindex: (texinfo)texindex.         Sort Texinfo index files
  64 +* makeinfo: (texinfo)makeinfo.         Translate Texinfo source
  65  @end direntry
  66
  67  @c Before release, run C-u C-c C-u C-a (texinfo-all-menus-update with a
  68 @@ -553,8 +553,8 @@
  69  Formatting and Printing Hardcopy
  70
  71  * Use TeX::                     Use @TeX{} to format for hardcopy.
  72 -* Format with tex/texindex::    How to format with explicit shell commands.
  73 -* Format with texi2dvi::        A simpler way to format.
  74 +* texindex::                    How to format with explicit shell commands.
  75 +* texi2dvi::                    A simpler way to format.
  76  * Print with lpr::              How to print.
  77  * Within Emacs::                How to format and print from an Emacs shell.
  78  * Texinfo Mode Printing::       How to format and print in Texinfo mode.
  79 @@ -578,7 +578,7 @@
  80  Creating an Info File
  81
  82  * makeinfo advantages::         @code{makeinfo} provides better error checking.
  83 -* Invoking makeinfo::           How to run @code{makeinfo} from a shell.
  84 +* makeinfo::                    How to run @code{makeinfo} from a shell.
  85  * makeinfo options::            Specify fill-column and other options.
  86  * Pointer Validation::          How to check that pointers point somewhere.
  87  * makeinfo in Emacs::           How to run @code{makeinfo} from Emacs.
  88 @@ -597,7 +597,7 @@
  89                                   located in other directories.
  90  * Installing Dir Entries::      How to specify what menu entry to add
  91                                   to the Info directory.
  92 -* Invoking install-info::       @code{install-info} options.
  93 +* install-info::                @code{install-info} options.
  94
  95  Generating HTML
  96
  97 @@ -2433,7 +2433,7 @@
  98  you must run the @code{texindex} command after first running the
  99  @code{tex} typesetting command; and then you must run the @code{tex}
 100  command again.  Or else run the @code{texi2dvi} command which
 101 -automatically creates indices as needed (@pxref{Format with texi2dvi}).
 102 +automatically creates indices as needed (@pxref{texi2dvi}).
 103
 104  Often, when you are writing a document, you want to typeset and print
 105  only part of a file to see what it will look like.  You can use the
 106 @@ -3638,8 +3638,8 @@
 107
 108  You need to include the @code{@@set@dots{}contentsaftertitlepage}
 109  commands early in the document (just after @code{@@setfilename}, for
 110 -example).  We recommend using @command{texi2dvi} (@pxref{Format with
 111 -texi2dvi}) to specify this without altering the source file at all.  For
 112 +example).  We recommend using @command{texi2dvi} (@pxref{texi2dvi})
 113 +to specify this without altering the source file at all.  For
 114  example:
 115  @example
 116  texi2dvi --texinfo=@@setcontentsaftertitlepage foo.texi
 117 @@ -13478,7 +13478,7 @@
 118  problems with @TeX{}.  If you get macro-related errors when producing
 119  the printed version of a manual, try expanding the macros with
 120  @command{makeinfo} by invoking @command{texi2dvi} with the @samp{-E}
 121 -option (@pxref{Format with texi2dvi}).
 122 +option (@pxref{texi2dvi}).
 123
 124  @itemize @bullet
 125  @item
 126 @@ -13704,8 +13704,8 @@
 127
 128  @menu
 129  * Use TeX::                     Use @TeX{} to format for hardcopy.
 130 -* Format with tex/texindex::    How to format with explicit shell commands.
 131 -* Format with texi2dvi::        A simpler way to format.
 132 +* texindex::                    How to format with explicit shell commands.
 133 +* texi2dvi::                    A simpler way to format.
 134  * Print with lpr::              How to print.
 135  * Within Emacs::                How to format and print from an Emacs shell.
 136  * Texinfo Mode Printing::       How to format and print in Texinfo mode.
 137 @@ -13737,7 +13737,7 @@
 138  File}).
 139
 140
 141 -@node Format with tex/texindex
 142 +@node texindex
 143  @section Format with @code{tex} and @code{texindex}
 144  @cindex Shell formatting with @code{tex} and @code{texindex}
 145  @cindex Formatting with @code{tex} and @code{texindex}
 146 @@ -13758,7 +13758,7 @@
 147  @pindex texindex
 148  The @code{tex} formatting command itself does not sort the indices; it
 149  writes an output file of unsorted index data.  (The @code{texi2dvi}
 150 -command automatically generates indices; @pxref{Format with texi2dvi,,
 151 +command automatically generates indices; @pxref{texi2dvi,,
 152  Format with @code{texi2dvi}}.)  To generate a printed index after
 153  running the @code{tex} command, you first need a sorted index to work
 154  from.  The @code{texindex} command sorts indices.  (The source file
 155 @@ -13835,7 +13835,7 @@
 156
 157  @pindex texi2dvi
 158  Alternatively, it's a one-step process: run @code{texi2dvi}
 159 -(@pxref{Format with texi2dvi}).
 160 +(@pxref{texi2dvi}).
 161
 162  You need not run @code{texindex} each time after you run @code{tex}.  If
 163  you do not, on the next run, the @code{tex} formatting command will use
 164 @@ -13867,7 +13867,7 @@
 165  (@pxref{Pointer Validation}).
 166
 167
 168 -@node Format with texi2dvi
 169 +@node texi2dvi
 170  @section Format with @code{texi2dvi}
 171  @pindex texi2dvi @r{(shell script)}
 172
 173 @@ -14419,7 +14419,7 @@
 174  @xref{small}, for information about
 175  commands that make it easier to produce examples for a smaller manual.
 176
 177 -@xref{Format with texi2dvi}, and @ref{Preparing for TeX,,Preparing for
 178 +@xref{texi2dvi}, and @ref{Preparing for TeX,,Preparing for
 179  @TeX{}}, for other ways to format with @code{@@smallbook} that do not
 180  require changing the source file.
 181
 182 @@ -14449,7 +14449,7 @@
 183  @end group
 184  @end example
 185
 186 -@xref{Format with texi2dvi}, and @ref{Preparing for TeX,,Preparing for
 187 +@xref{texi2dvi}, and @ref{Preparing for TeX,,Preparing for
 188  @TeX{}}, for other ways to format for different paper sizes that do not
 189  require changing the source file.
 190
 191 @@ -14495,7 +14495,7 @@
 192  margins, you must define a new command in @file{texinfo.tex} (or
 193  @file{texinfo.cnf}, @pxref{Preparing for TeX,,Preparing for @TeX{}}).
 194
 195 -@xref{Format with texi2dvi}, and @ref{Preparing for TeX,,Preparing for
 196 +@xref{texi2dvi}, and @ref{Preparing for TeX,,Preparing for
 197  @TeX{}}, for other ways to specify @code{@@pagesizes} that do not
 198  require changing the source file.
 199
 200 @@ -14658,7 +14658,7 @@
 201
 202  @menu
 203  * makeinfo advantages::         @code{makeinfo} provides better error checking.
 204 -* Invoking makeinfo::           How to run @code{makeinfo} from a shell.
 205 +* makeinfo::                    How to run @code{makeinfo} from a shell.
 206  * makeinfo options::            Specify fill-column and other options.
 207  * Pointer Validation::          How to check that pointers point somewhere.
 208  * makeinfo in Emacs::           How to run @code{makeinfo} from Emacs.
 209 @@ -14690,7 +14690,7 @@
 210  @code{makeinfo}.
 211
 212
 213 -@node Invoking makeinfo
 214 +@node makeinfo
 215  @subsection Running @code{makeinfo} from a Shell
 216  @pindex makeinfo
 217
 218 @@ -15383,7 +15383,7 @@
 219                                   located in other directories.
 220  * Installing Dir Entries::      How to specify what menu entry to add
 221                                   to the Info directory.
 222 -* Invoking install-info::       @code{install-info} options.
 223 +* install-info::                @code{install-info} options.
 224  @end menu
 225
 226
 227 @@ -15689,7 +15689,7 @@
 228  traditional @command{man} system.
 229
 230
 231 -@node Invoking install-info
 232 +@node install-info
 233  @subsection Invoking @command{install-info}
 234  @pindex install-info
 235
 236 @@ -16187,7 +16187,7 @@
 237
 238  In standard Texinfo, node names may not contain @@-commands.
 239  @command{makeinfo} has an option @option{--commands-in-node-names}
 240 -which partially supports it (@pxref{Invoking makeinfo}), but it is not
 241 +which partially supports it (@pxref{makeinfo}), but it is not
 242  robust and not recommended.
 243
 244  Thus, @command{makeinfo} also does not fully implement this part of