-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
+--- texinfo-4.7/doc/info-stnd.texi.orig 2004-03-24 02:41:06.000000000 +0100
++++ texinfo-4.7/doc/info-stnd.texi 2004-04-12 13:07:58.150558008 +0200
+@@ -35,10 +35,10 @@
+ @end quotation
+ @end copying
-@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
+-* info standalone: (info-stnd). Read Info documents without Emacs.
+-* infokey: (info-stnd)Invoking infokey. Compile Info customizations.
++* info standalone: (info-stnd). Read Info documents without Emacs
++* infokey: (info-stnd)infokey. Compile Info customizations
@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$
+ @titlepage
+@@ -1963,12 +1963,12 @@
+ textual source file using the @code{infokey} command.
+
+ @menu
+-* Invoking infokey::
++* infokey::
+ * infokey source format::
+ @end menu
+
+
+-@node Invoking infokey
++@node infokey
+ @section Invoking @command{infokey}
+
+ @cindex invoking infokey
+--- texinfo-4.7/doc/info.texi.orig 2004-04-06 10:21:35.000000000 +0200
++++ texinfo-4.7/doc/info.texi 2004-04-12 13:08:41.859913176 +0200
+@@ -37,9 +37,9 @@
+ @end quotation
+ @end copying
-@dircategory Texinfo documentation system
+@dircategory Texinfo documentation system:
@direntry
--* Info: (info). Documentation browsing system.
-+* Info: (info). Documentation browsing system
+-* Info: (info). How to use the documentation browsing system.
++* Info: (info). The 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
+ @titlepage
+--- texinfo-4.12/doc/texinfo.txi.orig 2008-04-09 19:07:31.000000000 +0200
++++ texinfo-4.12/doc/texinfo.txi 2008-05-29 23:44:49.056866313 +0200
+@@ -56,15 +56,15 @@
+ @end quotation
+ @end copying
-@dircategory Texinfo documentation system
+@dircategory Texinfo documentation system:
-* Texinfo: (texinfo). The GNU documentation format.
-* install-info: (texinfo)Invoking install-info. Update info/dir entries.
-* texi2dvi: (texinfo)Format with texi2dvi. Print Texinfo documents.
+-* texi2pdf: (texinfo)PDF Output. PDF output for Texinfo.
+-* pdftexi2dvi: (texinfo)PDF Output. PDF output for Texinfo.
-* 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
++* Texinfo: (texinfo). The GNU documentation format
++* install-info: (texinfo)install-info. Update info/dir entries
++* texi2dvi: (texinfo)texi2dvi. Print Texinfo documents
++* texi2pdf: (texinfo)texi2pdf. PDF output for Texinfo
++* pdftexi2dvi: (texinfo)pdftexi2dvi. PDF output for Texinfo
++* 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 @@
+@@ -568,8 +568,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.
++* 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.
+@@ -582,7 +582,7 @@
+ * pagesizes:: How to print with customized page sizes.
+ * Cropmarks and Magnification:: How to print marks to indicate the size
+ of pages and how to print scaled up output.
+-* PDF Output:: Portable Document Format output.
++* texi2pdf:: Portable Document Format output.
+ * Obtaining TeX:: How to Obtain @TeX{}.
+
+ Creating and Installing Info Files
+@@ -593,7 +593,7 @@
+ Creating an Info File
+
+ * makeinfo advantages:: @code{makeinfo} provides better error checking.
+-* Invoking makeinfo:: How to run @code{makeinfo} from a shell.
++* makeinfo:: How to run @code{makeinfo} from a shell.
+ * makeinfo options:: Specify fill-column and other options.
+ * Pointer Validation:: How to check that pointers point somewhere.
+ * makeinfo in Emacs:: How to run @code{makeinfo} from Emacs.
+@@ -612,7 +612,7 @@
+ located in other directories.
* Installing Dir Entries:: How to specify what menu entry to add
- to the Info directory.
+ to the Info directory.
-* Invoking install-info:: @code{install-info} options.
-+* install-info:: @code{install-info} options.
-
- Include Files
++* install-info:: @code{install-info} options.
-@@ -586,7 +586,7 @@
+ Generating HTML
- Formatting Mistakes
+@@ -907,7 +907,7 @@
+ @uref{http://tug.org/TUGboat/Articles/tb22-3/tb72beebe-pdf.pdf} has
+ some background. Texinfo uses the @command{pdftex} program, a variant
+ of @TeX{}, to output PDF; see
+-@uref{http://tug.org/applications/pdftex}. @xref{PDF Output}.
++@uref{http://tug.org/applications/pdftex}. @xref{texi2pdf}.
--* 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 @@
+ @item XML
+ @cindex XML output
+@@ -2416,7 +2416,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
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 @@
+@@ -3612,8 +3612,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). We recommend using @command{texi2dvi} (@pxref{Format with
+-texi2dvi}) to specify this without altering the source file at all. For
++example). We recommend using @command{texi2dvi} (@pxref{texi2dvi})
++to specify this without altering the source file at all. For
+ example:
@example
- texi2dvi --texinfo=@@setshortcontentsaftertitlepage foo.texi
-@@ -12759,8 +12759,8 @@
+ texi2dvi --texinfo=@@setcontentsaftertitlepage foo.texi
+@@ -14062,7 +14062,7 @@
+ problems with @TeX{}. If you get macro-related errors when producing
+ the printed version of a manual, try expanding the macros with
+ @command{makeinfo} by invoking @command{texi2dvi} with the @samp{-E}
+-option (@pxref{Format with texi2dvi}).
++option (@pxref{texi2dvi}).
+
+ @itemize @bullet
+ @item
+@@ -14331,8 +14331,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.
++* 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}).
+@@ -14345,7 +14345,7 @@
+ * pagesizes:: How to print with customized page sizes.
+ * Cropmarks and Magnification:: How to print marks to indicate the size
+ of pages and how to print scaled up output.
+-* PDF Output:: Portable Document Format output.
++* texi2pdf:: Portable Document Format output.
+ * Obtaining TeX:: How to Obtain @TeX{}.
+ @end menu
+
+@@ -14364,7 +14364,7 @@
+ File}).
-@node Format with tex/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 @@
+@@ -14461,7 +14461,7 @@
@pindex texi2dvi
Alternatively, it's a one-step process: run @code{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 @@
+@@ -14493,7 +14493,7 @@
(@pxref{Pointer Validation}).
@section Format with @code{texi2dvi}
@pindex texi2dvi @r{(shell script)}
-@@ -12956,7 +12956,7 @@
- For a list of other options, run @samp{texi2dvi --help}.
+@@ -14530,7 +14530,7 @@
-
--@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 @@
+ @opindex --pdf @r{(@command{texi2dvi})}
+ With the @option{--pdf} option, @command{texi2dvi} produces PDF output
+-instead of DVI (@pxref{PDF Output}), by running @command{pdftex}
++instead of DVI (@pxref{texi2pdf}), by running @command{pdftex}
+ instead of @command{tex}. Alternatively, the command
+ @command{texi2pdf} is an abbreviation for running @samp{texi2dvi
+ --pdf}. The command @command{pdftexi2dvi} is also supported as a
+@@ -15107,7 +15107,7 @@
@xref{small}, for information about
commands that make it easier to produce examples for a smaller manual.
@TeX{}}, for other ways to format with @code{@@smallbook} that do not
require changing the source file.
-@@ -13495,7 +13495,7 @@
+@@ -15137,7 +15137,7 @@
@end group
@end example
@TeX{}}, for other ways to format for different paper sizes that do not
require changing the source file.
-@@ -13541,7 +13541,7 @@
+@@ -15183,7 +15183,7 @@
margins, you must define a new command in @file{texinfo.tex} (or
@file{texinfo.cnf}, @pxref{Preparing for TeX,,Preparing for @TeX{}}).
@TeX{}}, for other ways to specify @code{@@pagesizes} that do not
require changing the source file.
-@@ -14386,7 +14386,7 @@
- located in other directories.
+@@ -15252,7 +15252,7 @@
+ magnifications. Be prepared to experiment.
+
+
+-@node PDF Output
++@node texi2pdf
+ @section PDF Output
+ @cindex PDF output
+
+@@ -15260,7 +15260,7 @@
+ The simplest way to generate PDF output from Texinfo source is to run
+ the convenience script @command{texi2pdf} (or @command{pdftexi2dvi});
+ this simply executes the @command{texi2dvi} script with the
+-@option{--pdf} option (@pxref{Format with texi2dvi}). If for some
++@option{--pdf} option (@pxref{texi2dvi}). If for some
+ reason you want to process the document by hand, simply run the
+ @command{pdftex} program instead of plain @command{tex}. That is, run
+ @samp{pdftex foo.texi} instead of @samp{tex foo.texi}.
+@@ -15364,7 +15364,7 @@
+
+ @menu
+ * makeinfo advantages:: @code{makeinfo} provides better error checking.
+-* Invoking makeinfo:: How to run @code{makeinfo} from a shell.
++* makeinfo:: How to run @code{makeinfo} from a shell.
+ * makeinfo options:: Specify fill-column and other options.
+ * Pointer Validation:: How to check that pointers point somewhere.
+ * makeinfo in Emacs:: How to run @code{makeinfo} from Emacs.
+@@ -15396,7 +15396,7 @@
+ @code{makeinfo}.
+
+
+-@node Invoking makeinfo
++@node makeinfo
+ @subsection Running @code{makeinfo} from a Shell
+ @pindex makeinfo
+
+@@ -16111,7 +16111,7 @@
+ located in other directories.
* Installing Dir Entries:: How to specify what menu entry to add
- to the Info directory.
+ to the Info directory.
-* Invoking install-info:: @code{install-info} options.
-+* install-info:: @code{install-info} options.
++* install-info:: @code{install-info} options.
@end menu
-@@ -14633,7 +14633,7 @@
+@@ -16359,7 +16359,7 @@
@@dircategory Texinfo documentation system
@@direntry
* Texinfo: (texinfo). The GNU documentation format.
@dots{}
@@end direntry
@end smallexample
-@@ -14644,7 +14644,7 @@
+@@ -16370,7 +16370,7 @@
INFO-DIR-SECTION Texinfo documentation system
START-INFO-DIR-ENTRY
* Texinfo: (texinfo). The GNU documentation format.
@dots{}
END-INFO-DIR-ENTRY
@end smallexample
-@@ -14670,8 +14670,8 @@
- entry for the manual as a whole in the appropriate other category.
+@@ -16392,7 +16392,7 @@
+ most others. Description for individual utilities best start in
+ column 48, where possible. For more information about formatting see
+ the @samp{--calign}, @samp{--align}, and @samp{--max-width} options in
+-@ref{Invoking install-info}.
++@ref{install-info}.
+
+ If you use @code{@@dircategory} more than once in the Texinfo source,
+ each usage specifies the `current' category; any subsequent
+@@ -16427,7 +16427,7 @@
+ traditional @command{man} system.
-@node Invoking install-info
--@subsection Invoking install-info
+@node install-info
-+@subsection install-info
-
+ @subsection Invoking @command{install-info}
@pindex install-info
-@@ -17064,7 +17064,7 @@
- command and you can use the @kbd{M-x Info-validate} command.@refill
+@@ -17050,7 +17050,7 @@
- @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
+ In standard Texinfo, node names may not contain @@-commands.
+ @command{makeinfo} has an option @option{--commands-in-node-names}
+-which partially supports it (@pxref{Invoking makeinfo}), but it is not
++which partially supports it (@pxref{makeinfo}), but it is not
+ robust and not recommended.
--@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
+ Thus, @command{makeinfo} also does not fully implement this part of
projects / packages / texinfo.git / blobdiff