texinfo-info.patch

   1 diff -Nru texinfo-3.12s/doc/texinfo.txi texinfo-3.12s.new/doc/texinfo.txi
   2 --- texinfo-3.12s/doc/texinfo.txi       Mon Aug  9 22:43:55 1999
   3 +++ texinfo-3.12s.new/doc/texinfo.txi   Wed Sep  8 22:06:16 1999
   4 @@ -22,13 +22,13 @@
   5
   6  @comment %**end of header
   7
   8 -@dircategory Texinfo documentation system
   9 +@dircategory Texinfo documentation system:
  10  @direntry
  11 -* Texinfo: (texinfo).           The GNU documentation format.
  12 -* install-info: (texinfo)Invoking install-info. Update info/dir entries.
  13 -* texi2dvi: (texinfo)Format with texi2dvi.      Print Texinfo documents.
  14 -* texindex: (texinfo)Format with tex/texindex.  Sort Texinfo index files.
  15 -* makeinfo: (texinfo)makeinfo Preferred.        Translate Texinfo source.
  16 +* Texinfo: (texinfo)                   The GNU documentation format
  17 +* install-info: (texinfo)install-info  Update info/dir entries
  18 +* texi2dvi: (texinfo)texi2dvi          Print Texinfo documents
  19 +* texindex: (texinfo)texindex          Sort Texinfo index files
  20 +* makeinfo: (texinfo)makeinfo          Translate Texinfo source
  21  @end direntry
  22
  23  @c Before release, run C-u C-c C-u C-a (texinfo-all-menus-update with a
  24 @@ -538,8 +538,8 @@
  25  Formatting and Printing Hardcopy
  26
  27  * Use TeX::                     Use @TeX{} to format for hardcopy.
  28 -* Format with tex/texindex::    How to format with explicit shell commands.
  29 -* Format with texi2dvi::        A simpler way to format.
  30 +* texindex::                   How to format with explicit shell commands.
  31 +* texi2dvi::                   A simpler way to format.
  32  * Print with lpr::              How to print.
  33  * Within Emacs::                How to format and print from an Emacs shell.
  34  * Texinfo Mode Printing::       How to format and print in Texinfo mode.
  35 @@ -582,7 +582,7 @@
  36                                    located in other directories.
  37  * Installing Dir Entries::      How to specify what menu entry to add
  38                                    to the Info directory.
  39 -* Invoking install-info::       @code{install-info} options.
  40 +* install-info::               @code{install-info} options.
  41
  42  Sample Permissions
  43
  44 @@ -610,7 +610,7 @@
  45
  46  Formatting Mistakes
  47
  48 -* makeinfo Preferred::          @code{makeinfo} finds errors.
  49 +* makeinfo::                   @code{makeinfo} finds errors.
  50  * Debugging with Info::         How to catch errors with Info formatting.
  51  * Debugging with TeX::          How to catch errors with @TeX{} formatting.
  52  * Using texinfo-show-structure::  How to use @code{texinfo-show-structure}.
  53 @@ -2286,7 +2286,7 @@
  54  you must run the @code{texindex} command after first running the
  55  @code{tex} typesetting command; and then you must run the @code{tex}
  56  command again.  Or else run the @code{texi2dvi} command which
  57 -automatically creates indices as needed (@pxref{Format with texi2dvi}).
  58 +automatically creates indices as needed (@pxref{texi2dvi}).
  59
  60  Often, when you are writing a document, you want to typeset and print
  61  only part of a file to see what it will look like.  You can use the
  62 @@ -3877,8 +3877,8 @@
  63
  64  You need to include the @code{@@set@dots{}contentsaftertitlepage}
  65  commands early in the document (just after @code{@@setfilename}, for
  66 -example).  Or, if you're using @command{texi2dvi} (@pxref{Format with
  67 -texi2dvi}), you can use its @option{--texinfo} option to specify this
  68 +example).  Or, if you're using @command{texi2dvi} (@pxref{texi2dvi}),
  69 +you can use its @option{--texinfo} option to specify this
  70  without altering the source file at all.  For example:
  71  @example
  72  texi2dvi --texinfo=@@setshortcontentsaftertitlepage foo.texi
  73 @@ -12629,8 +12629,8 @@
  74
  75  @menu
  76  * Use TeX::                     Use @TeX{} to format for hardcopy.
  77 -* Format with tex/texindex::    How to format with explicit shell commands.
  78 -* Format with texi2dvi::        A simpler way to format.
  79 +* texindex::                   How to format with explicit shell commands.
  80 +* texi2dvi::                   A simpler way to format.
  81  * Print with lpr::              How to print.
  82  * Within Emacs::                How to format and print from an Emacs shell.
  83  * Texinfo Mode Printing::       How to format and print in Texinfo mode.
  84 @@ -12660,7 +12660,7 @@
  85  make an Info file (@pxref{Creating an Info File}).
  86
  87
  88 -@node Format with tex/texindex
  89 +@node texindex
  90  @section Format with @code{tex} and @code{texindex}
  91  @cindex Shell formatting with @code{tex} and @code{texindex}
  92  @cindex Formatting with @code{tex} and @code{texindex}
  93 @@ -12681,7 +12681,7 @@
  94  @pindex texindex
  95  The @code{tex} formatting command itself does not sort the indices; it
  96  writes an output file of unsorted index data.  (The @code{texi2dvi}
  97 -command automatically generates indices; @pxref{Format with texi2dvi,,
  98 +command automatically generates indices; @pxref{texi2dvi,,
  99  Format with @code{texi2dvi}}.)  To generate a printed index after
 100  running the @code{tex} command, you first need a sorted index to work
 101  from.  The @code{texindex} command sorts indices.  (The source file
 102 @@ -12755,7 +12755,7 @@
 103
 104  @pindex texi2dvi
 105  Alternatively, it's a one-step process: run @code{texi2dvi}
 106 -(@pxref{Format with texi2dvi}).
 107 +(@pxref{texi2dvi}).
 108
 109  You need not run @code{texindex} each time after you run @code{tex}.  If
 110  you do not, on the next run, the @code{tex} formatting command will use
 111 @@ -12787,7 +12787,7 @@
 112  (@pxref{Pointer Validation}).
 113
 114
 115 -@node Format with texi2dvi
 116 +@node texi2dvi
 117  @section Format with @code{texi2dvi}
 118  @pindex texi2dvi @r{(shell script)}
 119
 120 @@ -12823,7 +12823,7 @@
 121  For a list of other options, run @samp{texi2dvi --help}.
 122
 123
 124 -@node Print with lpr, Within Emacs, Format with texi2dvi, Hardcopy
 125 +@node Print with lpr, Within Emacs, texi2dvi, Hardcopy
 126  @section Shell Print Using @code{lpr -d}
 127  @pindex lpr @r{(DVI print command)}
 128
 129 @@ -13331,7 +13331,7 @@
 130  @xref{small}, for information about
 131  commands that make it easier to produce examples for a smaller manual.
 132
 133 -@xref{Format with texi2dvi}, and @ref{Preparing for TeX,,Preparing for
 134 +@xref{texi2dvi}, and @ref{Preparing for TeX,,Preparing for
 135  @TeX{}}, for other ways to format with @code{@@smallbook} that do not
 136  require changing the source file.
 137
 138 @@ -13360,7 +13360,7 @@
 139  @end group
 140  @end example
 141
 142 -@xref{Format with texi2dvi}, and @ref{Preparing for TeX,,Preparing for
 143 +@xref{texi2dvi}, and @ref{Preparing for TeX,,Preparing for
 144  @TeX{}}, for other ways to format with @code{@@afourpaper} that do not
 145  require changing the source file.
 146
 147 @@ -13406,7 +13406,7 @@
 148  margins, you must define a new command in @file{texinfo.tex} (or
 149  @file{texinfo.cnf}, @pxref{Preparing for TeX,,Preparing for @TeX{}}).
 150
 151 -@xref{Format with texi2dvi}, and @ref{Preparing for TeX,,Preparing for
 152 +@xref{texi2dvi}, and @ref{Preparing for TeX,,Preparing for
 153  @TeX{}}, for other ways to specify @code{@@pagesizes} that do not
 154  require changing the source file.
 155
 156 @@ -14222,7 +14222,7 @@
 157                                    located in other directories.
 158  * Installing Dir Entries::      How to specify what menu entry to add
 159                                    to the Info directory.
 160 -* Invoking install-info::       @code{install-info} options.
 161 +* install-info::               @code{install-info} options.
 162  @end menu
 163
 164
 165 @@ -14447,7 +14447,7 @@
 166  special CTRL-_ character that Info needs will be present.
 167
 168
 169 -@node Installing Dir Entries, Invoking install-info, Other Info Directories, Install an Info File
 170 +@node Installing Dir Entries, install-info, Other Info Directories, Install an Info File
 171  @subsection Installing Info Directory Files
 172
 173  When you install an Info file onto your system, you can use the program
 174 @@ -14468,7 +14468,7 @@
 175  @@dircategory Texinfo documentation system
 176  @@direntry
 177  * Texinfo: (texinfo).           The GNU documentation format.
 178 -* install-info: (texinfo)Invoking install-info. @dots{}
 179 +* install-info: (texinfo)install-info. @dots{}
 180  @dots{}
 181  @@end direntry
 182  @end smallexample
 183 @@ -14479,7 +14479,7 @@
 184  INFO-DIR-SECTION Texinfo documentation system
 185  START-INFO-DIR-ENTRY
 186  * Texinfo: (texinfo).           The GNU documentation format.
 187 -* install-info: (texinfo)Invoking install-info. @dots{}
 188 +* install-info: (texinfo)install-info. @dots{}
 189  @dots{}
 190  END-INFO-DIR-ENTRY
 191  @end smallexample
 192 @@ -14505,8 +14505,8 @@
 193  entry for the manual as a whole in the appropriate other category.
 194
 195
 196 -@node Invoking install-info
 197 -@subsection Invoking install-info
 198 +@node install-info
 199 +@subsection install-info
 200
 201  @pindex install-info
 202
 203 @@ -17047,7 +17047,7 @@
 204  command and you can use the @kbd{M-x Info-validate} command.@refill
 205
 206  @menu
 207 -* makeinfo Preferred::          @code{makeinfo} finds errors.
 208 +* makeinfo::                   @code{makeinfo} finds errors.
 209  * Debugging with Info::         How to catch errors with Info formatting.
 210  * Debugging with TeX::          How to catch errors with @TeX{} formatting.
 211  * Using texinfo-show-structure::  How to use @code{texinfo-show-structure}.
 212 @@ -17055,7 +17055,7 @@
 213  * Running Info-Validate::       How to find badly referenced nodes.
 214  @end menu
 215
 216 -@node makeinfo Preferred, Debugging with Info, Catching Mistakes, Catching Mistakes
 217 +@node makeinfo, Debugging with Info, Catching Mistakes, Catching Mistakes
 218  @ifinfo
 219  @heading @code{makeinfo} Find Errors
 220  @end ifinfo
 221 @@ -17074,7 +17074,7 @@
 222  cannot use @code{makeinfo}, or your problem is very puzzling, then you
 223  may want to use the tools described in this appendix.@refill
 224
 225 -@node Debugging with Info, Debugging with TeX, makeinfo Preferred, Catching Mistakes
 226 +@node Debugging with Info, Debugging with TeX, makeinfo, Catching Mistakes
 227  @comment  node-name,  next,  previous,  up
 228  @section Catching Errors with Info Formatting
 229  @cindex Catching errors with Info formatting