diff -Nur texinfo-4.0b.orig/doc/info-stnd.texi texinfo-4.0b/doc/info-stnd.texi --- texinfo-4.0b.orig/doc/info-stnd.texi Fri Jun 25 23:57:05 1999 +++ texinfo-4.0b/doc/info-stnd.texi Tue May 22 19:55:40 2001 @@ -10,9 +10,9 @@ @include version.texi -@dircategory Texinfo documentation system +@dircategory Texinfo documentation system: @direntry -* Standalone info program: (info-stnd). Standalone Info-reading program. +* Standalone info program: (info-stnd). Standalone Info-reading program @end direntry @ifinfo diff -Nur texinfo-4.0b.orig/doc/info.texi texinfo-4.0b/doc/info.texi --- texinfo-4.0b.orig/doc/info.texi Tue May 1 21:45:12 2001 +++ texinfo-4.0b/doc/info.texi Tue May 22 19:55:40 2001 @@ -8,9 +8,9 @@ @comment %**end of header @comment $Id$ -@dircategory Texinfo documentation system +@dircategory Texinfo documentation system: @direntry -* Info: (info). Documentation browsing system. +* Info: (info). Documentation browsing system @end direntry @ifinfo diff -Nur texinfo-4.0b.orig/doc/texinfo.txi texinfo-4.0b/doc/texinfo.txi --- texinfo-4.0b.orig/doc/texinfo.txi Tue May 1 21:36:20 2001 +++ texinfo-4.0b/doc/texinfo.txi Tue May 22 20:00:29 2001 @@ -22,13 +22,13 @@ @comment %**end of header -@dircategory Texinfo documentation system +@dircategory Texinfo documentation system: @direntry -* Texinfo: (texinfo). The GNU documentation format. -* install-info: (texinfo)Invoking install-info. Update info/dir entries. -* texi2dvi: (texinfo)Format with texi2dvi. Print Texinfo documents. -* texindex: (texinfo)Format with tex/texindex. Sort Texinfo index files. -* makeinfo: (texinfo)Invoking makeinfo. Translate Texinfo source. +* Texinfo: (texinfo) The GNU documentation format +* install-info: (texinfo)install-info Update info/dir entries +* texi2dvi: (texinfo)texi2dvi Print Texinfo documents +* texindex: (texinfo)texindex Sort Texinfo index files +* makeinfo: (texinfo)makeinfo Translate Texinfo source @end direntry @c Before release, run C-u C-c C-u C-a (texinfo-all-menus-update with a @@ -520,8 +520,8 @@ Formatting and Printing Hardcopy * Use TeX:: Use @TeX{} to format for hardcopy. -* Format with tex/texindex:: How to format with explicit shell commands. -* Format with texi2dvi:: A simpler way to format. +* texindex:: How to format with explicit shell commands. +* texi2dvi:: A simpler way to format. * Print with lpr:: How to print. * Within Emacs:: How to format and print from an Emacs shell. * Texinfo Mode Printing:: How to format and print in Texinfo mode. @@ -564,7 +564,7 @@ located in other directories. * Installing Dir Entries:: How to specify what menu entry to add to the Info directory. -* Invoking install-info:: @code{install-info} options. +* install-info:: @code{install-info} options. Include Files @@ -586,7 +586,7 @@ Formatting Mistakes -* makeinfo Preferred:: @code{makeinfo} finds errors. +* makeinfo:: @code{makeinfo} finds errors. * Debugging with Info:: How to catch errors with Info formatting. * Debugging with TeX:: How to catch errors with @TeX{} formatting. * Using texinfo-show-structure:: How to use @code{texinfo-show-structure}. @@ -2260,7 +2260,7 @@ you must run the @code{texindex} command after first running the @code{tex} typesetting command; and then you must run the @code{tex} command again. Or else run the @code{texi2dvi} command which -automatically creates indices as needed (@pxref{Format with texi2dvi}). +automatically creates indices as needed (@pxref{texi2dvi}). Often, when you are writing a document, you want to typeset and print only part of a file to see what it will look like. You can use the @@ -3848,8 +3848,8 @@ You need to include the @code{@@set@dots{}contentsaftertitlepage} commands early in the document (just after @code{@@setfilename}, for -example). Or, if you're using @command{texi2dvi} (@pxref{Format with -texi2dvi}), you can use its @option{--texinfo} option to specify this +example). Or, if you're using @command{texi2dvi} (@pxref{texi2dvi}), +you can use its @option{--texinfo} option to specify this without altering the source file at all. For example: @example texi2dvi --texinfo=@@setshortcontentsaftertitlepage foo.texi @@ -12759,8 +12759,8 @@ @menu * Use TeX:: Use @TeX{} to format for hardcopy. -* Format with tex/texindex:: How to format with explicit shell commands. -* Format with texi2dvi:: A simpler way to format. +* texindex:: How to format with explicit shell commands. +* texi2dvi:: A simpler way to format. * Print with lpr:: How to print. * Within Emacs:: How to format and print from an Emacs shell. * Texinfo Mode Printing:: How to format and print in Texinfo mode. @@ -12790,7 +12790,7 @@ make an Info file (@pxref{Creating an Info File}). -@node Format with tex/texindex +@node texindex @section Format with @code{tex} and @code{texindex} @cindex Shell formatting with @code{tex} and @code{texindex} @cindex Formatting with @code{tex} and @code{texindex} @@ -12811,7 +12811,7 @@ @pindex texindex The @code{tex} formatting command itself does not sort the indices; it writes an output file of unsorted index data. (The @code{texi2dvi} -command automatically generates indices; @pxref{Format with texi2dvi,, +command automatically generates indices; @pxref{texi2dvi,, Format with @code{texi2dvi}}.) To generate a printed index after running the @code{tex} command, you first need a sorted index to work from. The @code{texindex} command sorts indices. (The source file @@ -12888,7 +12888,7 @@ @pindex texi2dvi Alternatively, it's a one-step process: run @code{texi2dvi} -(@pxref{Format with texi2dvi}). +(@pxref{texi2dvi}). You need not run @code{texindex} each time after you run @code{tex}. If you do not, on the next run, the @code{tex} formatting command will use @@ -12920,7 +12920,7 @@ (@pxref{Pointer Validation}). -@node Format with texi2dvi +@node texi2dvi @section Format with @code{texi2dvi} @pindex texi2dvi @r{(shell script)} @@ -12956,7 +12956,7 @@ For a list of other options, run @samp{texi2dvi --help}. -@node Print with lpr, Within Emacs, Format with texi2dvi, Hardcopy +@node Print with lpr, Within Emacs, texi2dvi, Hardcopy @section Shell Print Using @code{lpr -d} @pindex lpr @r{(DVI print command)} @@ -13465,7 +13465,7 @@ @xref{small}, for information about commands that make it easier to produce examples for a smaller manual. -@xref{Format with texi2dvi}, and @ref{Preparing for TeX,,Preparing for +@xref{texi2dvi}, and @ref{Preparing for TeX,,Preparing for @TeX{}}, for other ways to format with @code{@@smallbook} that do not require changing the source file. @@ -13495,7 +13495,7 @@ @end group @end example -@xref{Format with texi2dvi}, and @ref{Preparing for TeX,,Preparing for +@xref{texi2dvi}, and @ref{Preparing for TeX,,Preparing for @TeX{}}, for other ways to format for different paper sizes that do not require changing the source file. @@ -13541,7 +13541,7 @@ margins, you must define a new command in @file{texinfo.tex} (or @file{texinfo.cnf}, @pxref{Preparing for TeX,,Preparing for @TeX{}}). -@xref{Format with texi2dvi}, and @ref{Preparing for TeX,,Preparing for +@xref{texi2dvi}, and @ref{Preparing for TeX,,Preparing for @TeX{}}, for other ways to specify @code{@@pagesizes} that do not require changing the source file. @@ -14386,7 +14386,7 @@ located in other directories. * Installing Dir Entries:: How to specify what menu entry to add to the Info directory. -* Invoking install-info:: @code{install-info} options. +* install-info:: @code{install-info} options. @end menu @@ -14633,7 +14633,7 @@ @@dircategory Texinfo documentation system @@direntry * Texinfo: (texinfo). The GNU documentation format. -* install-info: (texinfo)Invoking install-info. @dots{} +* install-info: (texinfo)install-info. @dots{} @dots{} @@end direntry @end smallexample @@ -14644,7 +14644,7 @@ INFO-DIR-SECTION Texinfo documentation system START-INFO-DIR-ENTRY * Texinfo: (texinfo). The GNU documentation format. -* install-info: (texinfo)Invoking install-info. @dots{} +* install-info: (texinfo)install-info. @dots{} @dots{} END-INFO-DIR-ENTRY @end smallexample @@ -14670,8 +14670,8 @@ entry for the manual as a whole in the appropriate other category. -@node Invoking install-info -@subsection Invoking install-info +@node install-info +@subsection install-info @pindex install-info @@ -17064,7 +17064,7 @@ command and you can use the @kbd{M-x Info-validate} command.@refill @menu -* makeinfo Preferred:: @code{makeinfo} finds errors. +* makeinfo:: @code{makeinfo} finds errors. * Debugging with Info:: How to catch errors with Info formatting. * Debugging with TeX:: How to catch errors with @TeX{} formatting. * Using texinfo-show-structure:: How to use @code{texinfo-show-structure}. @@ -17072,7 +17072,7 @@ * Running Info-Validate:: How to find badly referenced nodes. @end menu -@node makeinfo Preferred, Debugging with Info, Catching Mistakes, Catching Mistakes +@node makeinfo, Debugging with Info, Catching Mistakes, Catching Mistakes @ifinfo @heading @code{makeinfo} Find Errors @end ifinfo @@ -17091,7 +17091,7 @@ cannot use @code{makeinfo}, or your problem is very puzzling, then you may want to use the tools described in this appendix.@refill -@node Debugging with Info, Debugging with TeX, makeinfo Preferred, Catching Mistakes +@node Debugging with Info, Debugging with TeX, makeinfo, Catching Mistakes @comment node-name, next, previous, up @section Catching Errors with Info Formatting @cindex Catching errors with Info formatting