]>
Commit | Line | Data |
---|---|---|
608fd4fd | 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 @@ | |
88542f05 | 5 | |
88542f05 | 6 | @comment %**end of header |
88542f05 | 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 | ||
608fd4fd | 23 | @c Before release, run C-u C-c C-u C-a (texinfo-all-menus-update with a |
24 | @@ -538,8 +538,8 @@ | |
88542f05 | 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. | |
608fd4fd | 35 | @@ -582,7 +582,7 @@ |
88542f05 | 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 | ||
608fd4fd | 44 | @@ -610,7 +610,7 @@ |
88542f05 | 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}. | |
608fd4fd | 53 | @@ -2286,7 +2286,7 @@ |
88542f05 | 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 | |
608fd4fd | 62 | @@ -3877,8 +3877,8 @@ |
88542f05 | 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 | |
608fd4fd | 68 | +example). Or, if you're using @command{texi2dvi} (@pxref{texi2dvi}), |
88542f05 | 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 | |
608fd4fd | 73 | @@ -12629,8 +12629,8 @@ |
88542f05 | 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. | |
608fd4fd | 84 | @@ -12660,7 +12660,7 @@ |
85 | make an Info file (@pxref{Creating an Info File}). | |
88542f05 | 86 | |
88542f05 | 87 | |
608fd4fd | 88 | -@node Format with tex/texindex |
89 | +@node texindex | |
88542f05 | 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} | |
608fd4fd | 93 | @@ -12681,7 +12681,7 @@ |
88542f05 | 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 | |
608fd4fd | 102 | @@ -12755,7 +12755,7 @@ |
88542f05 | 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 | |
608fd4fd | 111 | @@ -12787,7 +12787,7 @@ |
88542f05 | 112 | (@pxref{Pointer Validation}). |
113 | ||
114 | ||
608fd4fd | 115 | -@node Format with texi2dvi |
116 | +@node texi2dvi | |
88542f05 | 117 | @section Format with @code{texi2dvi} |
118 | @pindex texi2dvi @r{(shell script)} | |
119 | ||
608fd4fd | 120 | @@ -12823,7 +12823,7 @@ |
88542f05 | 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 | ||
608fd4fd | 129 | @@ -13331,7 +13331,7 @@ |
88542f05 | 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 | ||
608fd4fd | 138 | @@ -13360,7 +13360,7 @@ |
88542f05 | 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 | ||
608fd4fd | 147 | @@ -13406,7 +13406,7 @@ |
88542f05 | 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 | ||
608fd4fd | 156 | @@ -14222,7 +14222,7 @@ |
88542f05 | 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 | ||
608fd4fd | 164 | |
165 | @@ -14447,7 +14447,7 @@ | |
88542f05 | 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 | |
608fd4fd | 171 | @subsection Installing Info Directory Files |
88542f05 | 172 | |
173 | When you install an Info file onto your system, you can use the program | |
608fd4fd | 174 | @@ -14468,7 +14468,7 @@ |
175 | @@dircategory Texinfo documentation system | |
88542f05 | 176 | @@direntry |
608fd4fd | 177 | * Texinfo: (texinfo). The GNU documentation format. |
88542f05 | 178 | -* install-info: (texinfo)Invoking install-info. @dots{} |
608fd4fd | 179 | +* install-info: (texinfo)install-info. @dots{} |
88542f05 | 180 | @dots{} |
181 | @@end direntry | |
182 | @end smallexample | |
608fd4fd | 183 | @@ -14479,7 +14479,7 @@ |
184 | INFO-DIR-SECTION Texinfo documentation system | |
88542f05 | 185 | START-INFO-DIR-ENTRY |
608fd4fd | 186 | * Texinfo: (texinfo). The GNU documentation format. |
88542f05 | 187 | -* install-info: (texinfo)Invoking install-info. @dots{} |
608fd4fd | 188 | +* install-info: (texinfo)install-info. @dots{} |
88542f05 | 189 | @dots{} |
190 | END-INFO-DIR-ENTRY | |
191 | @end smallexample | |
608fd4fd | 192 | @@ -14505,8 +14505,8 @@ |
193 | entry for the manual as a whole in the appropriate other category. | |
88542f05 | 194 | |
195 | ||
608fd4fd | 196 | -@node Invoking install-info |
197 | -@subsection Invoking install-info | |
198 | +@node install-info | |
199 | +@subsection install-info | |
88542f05 | 200 | |
201 | @pindex install-info | |
202 | ||
608fd4fd | 203 | @@ -17047,7 +17047,7 @@ |
88542f05 | 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}. | |
608fd4fd | 212 | @@ -17055,7 +17055,7 @@ |
88542f05 | 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 | |
608fd4fd | 221 | @@ -17074,7 +17074,7 @@ |
88542f05 | 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 |