texinfo ChangeLog doc/texinfo.txi

[Karl Berry]

CVSROOT:        /sources/texinfo
Module name:    texinfo
Changes by:     Karl Berry <karl>       12/04/24 17:41:35

Modified files:
        .              : ChangeLog 
        doc            : texinfo.txi 

Log message:
        use @TeX{} in node names and thus simplify cross references

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1358&r2=1.1359
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.440&r2=1.441

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1358
retrieving revision 1.1359
diff -u -b -r1.1358 -r1.1359
--- ChangeLog   24 Apr 2012 17:05:41 -0000      1.1358
+++ ChangeLog   24 Apr 2012 17:41:32 -0000      1.1359
@@ -1,5 +1,9 @@
 2012-04-24  Karl Berry  <address@hidden>
 
+       * doc/texinfo.txi (#line and TeX, Use TeX, Obtaining TeX,
+       Preparing for TeX, Debugging with TeX): use @TeX{} in node names
+       and thus simplify cross references.  Does not change Info node names.
+       
        * doc/texinfo.txi: update master menu.
 
 2012-04-23  Karl Berry  <address@hidden>

Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.440
retrieving revision 1.441
diff -u -b -r1.440 -r1.441
--- doc/texinfo.txi     24 Apr 2012 17:05:41 -0000      1.440
+++ doc/texinfo.txi     24 Apr 2012 17:41:33 -0000      1.441
@@ -1,5 +1,5 @@
 \input texinfo.tex    @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.440 2012/04/24 17:05:41 karl Exp $
address@hidden $Id: texinfo.txi,v 1.441 2012/04/24 17:41:33 karl Exp $
 @c Ordinarily, Texinfo files have the extension .texi.  But texinfo.texi
 @c clashes with texinfo.tex on 8.3 filesystems, so we use texinfo.txi.
 
@@ -570,7 +570,7 @@
 External Macro Processors: Line Directives
 
 * #line Directive::
-* TeX: #line and TeX.
+* TeX: #line and @TeX{}.
 * Syntax: #line Syntax Details.
 
 Include Files
@@ -586,7 +586,7 @@
 
 Formatting and Printing Hardcopy
 
-* Use TeX::                     Use @TeX{} to format for 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.
 * Print with lpr::              How to print.
@@ -594,7 +594,7 @@
 * Texinfo Mode Printing::       How to format and print in Texinfo mode.
 * Compile-Command::             How to print using Emacs's compile command.
 * Requirements Summary::        @TeX{} formatting requirements summary.
-* Preparing for TeX::           What to do before you use @TeX{}.
+* Preparing for @TeX{}::           What to do before you use @TeX{}.
 * Overfull hboxes::             What are and what to do with overfull hboxes.
 * smallbook::                   How to print small format books and manuals.
 * A4 Paper::                    How to print on A4 or A5 paper.
@@ -602,7 +602,7 @@
 * 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.
-* Obtaining TeX::               How to Obtain @TeX{}.
+* Obtaining @TeX{}::               How to obtain @TeX{}.
 
 @command{texi2any}: The Generic Translator for Texinfo
 
@@ -697,7 +697,7 @@
 
 * makeinfo Preferred::          @code{makeinfo} finds errors.
 * Debugging with Info::         How to catch errors with Info formatting.
-* Debugging with TeX::          How to catch errors with @TeX{} formatting.
+* Debugging with @TeX{}::           How to catch errors with @TeX{} formatting.
 * Using texinfo-show-structure::  How to use @code{texinfo-show-structure}.
 * Using occur::                 How to list all lines containing a pattern.
 * Running Info-Validate::       How to find badly referenced nodes.
@@ -1214,8 +1214,7 @@
 character-only terminal in Info form and in a typeset book, the
 formatting commands that Texinfo supports are necessarily limited.
 
-To get a copy of @TeX{}, see
address@hidden TeX, , How to Obtain @TeX{}}.
address@hidden @TeX{}}, for information on acquiring @TeX{}.
 
 
 @node Formatting Commands
@@ -3076,7 +3075,7 @@
 manual with @TeX{}, but it is nevertheless essential: it opens the
 index and other auxiliary files used by Texinfo, and also reads
 @file{texinfo.cnf} if that file is present on your system
-(@pxref{Preparing for TeX,, Preparing for @TeX{}}).
+(@pxref{Preparing for @TeX{}}).
 
 If there is no @code{@@setfilename} line, @code{makeinfo} uses the
 input file name to determine the output name: first, any of the
@@ -15085,7 +15084,7 @@
 
 @menu
 * #line Directive::
-* TeX: #line and TeX.
+* TeX: #line and @TeX{}.
 * Syntax: #line Syntax Details.
 @end menu
 
@@ -15138,7 +15137,7 @@
 disabled inside verbatim blocks.
 
 
address@hidden #line and TeX
address@hidden #line and @TeX{}
 @subsection @samp{#line} and @TeX{}
 @cindex @TeX{} and @samp{#line} directives
 @cindex @samp{#line} directives, not processing with @TeX{}
@@ -15532,7 +15531,7 @@
 print queue, and delete a job from the print queue.
 
 @menu
-* Use TeX::                     Use @TeX{} to format for 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.
 * Print with lpr::              How to print.
@@ -15540,7 +15539,7 @@
 * Texinfo Mode Printing::       How to format and print in Texinfo mode.
 * Compile-Command::             How to print using Emacs's compile command.
 * Requirements Summary::        @TeX{} formatting requirements summary.
-* Preparing for TeX::           What to do before you use @TeX{}.
+* Preparing for @TeX{}::           What to do before you use @TeX{}.
 * Overfull hboxes::             What are and what to do with overfull hboxes.
 * smallbook::                   How to print small format books and manuals.
 * A4 Paper::                    How to print on A4 or A5 paper.
@@ -15548,16 +15547,16 @@
 * 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.
-* Obtaining TeX::               How to Obtain @TeX{}.
+* Obtaining @TeX{}::               How to obtain @TeX{}.
 @end menu
 
address@hidden Use TeX
address@hidden Use @TeX{}
 @section Use @TeX{}
 
 The typesetting program called @TeX{} is used for formatting a Texinfo
-file.  @TeX{} is a very powerful typesetting program and, if used correctly,
-does an exceptionally good job.  (@xref{Obtaining TeX, , How to Obtain
address@hidden, for information on how to obtain @TeX{}.)
+file.  @TeX{} is a very powerful typesetting program and, if used
+correctly, does an exceptionally good job.  (@xref{Obtaining @TeX{}},
+for information on how to obtain @TeX{}.)
 
 The standalone @code{makeinfo} program and Emacs functions
 @code{texinfo-format-region} and @code{texinfo-format-buffer} commands
@@ -15729,7 +15728,7 @@
 @code{@@afourpaper} (@pxref{A4 Paper}), or @code{@@pagesizes}
 (@pxref{pagesizes}), without actually changing the document source.
 (You can also do this on a site-wide basis with @file{texinfo.cnf};
address@hidden for TeX,,Preparing for @TeX{}}).
address@hidden for @TeX{}}).
 
 @opindex address@hidden, for @command{texi2dvi}}
 @pindex pdftexi2dvi
@@ -16104,7 +16103,7 @@
 @end itemize
 
 
address@hidden Preparing for TeX
address@hidden Preparing for @TeX{}
 @section Preparing for @TeX{}
 @cindex Preparing for @TeX{}
 @cindex @TeX{} input initialization
@@ -16258,7 +16257,7 @@
 @TeX{} also provides the line number in the Texinfo source file and
 the text of the offending line, which is marked at all the places that
 @TeX{} considered hyphenation.
address@hidden with TeX, , Catching Errors with @TeX{} Formatting},
address@hidden with @TeX{}},
 for more information about typesetting errors.
 
 If the Texinfo file has an overfull hbox, you can rewrite the sentence
@@ -16336,9 +16335,9 @@
 @xref{small}, for information about
 commands that make it easier to produce examples for a smaller manual.
 
address@hidden with texi2dvi}, and @ref{Preparing for TeX,,Preparing for
address@hidden, for other ways to format with @code{@@smallbook} that do not
-require changing the source file.
address@hidden with texi2dvi}, and @ref{Preparing for @TeX{}}, for other
+ways to format with @code{@@smallbook} that do not require changing
+the source file.
 
 
 @node A4 Paper
@@ -16366,9 +16365,9 @@
 @end group
 @end example
 
address@hidden with texi2dvi}, and @ref{Preparing for TeX,,Preparing for
address@hidden, for other ways to format for different paper sizes that do not
-require changing the source file.
address@hidden with texi2dvi}, and @ref{Preparing for @TeX{}}, for other
+ways to format for different paper sizes that do not require changing
+the source file.
 
 @findex afourlatex
 @findex afourwide
@@ -16409,12 +16408,12 @@
 
 @cindex Margins on page, not controllable
 To make more elaborate changes, such as changing any of the page
-margins, you must define a new command in @file{texinfo.tex} (or
address@hidden, @pxref{Preparing for TeX,,Preparing for @TeX{}}).
+margins, you must define a new command in @file{texinfo.tex} or
address@hidden
 
address@hidden with texi2dvi}, and @ref{Preparing for TeX,,Preparing for
address@hidden, for other ways to specify @code{@@pagesizes} that do not
-require changing the source file.
address@hidden with texi2dvi}, and @ref{Preparing for @TeX{}}, for other
+ways to specify @code{@@pagesizes} that do not require changing the
+source file.
 
 @code{@@pagesizes} is ignored by @code{makeinfo}.
 
@@ -16524,8 +16523,8 @@
 self-contained file, so it has its place.
 
 
address@hidden Obtaining TeX
address@hidden How to Obtain @TeX{}
address@hidden Obtaining @TeX{}
address@hidden Obtaining @TeX{}
 @cindex Obtaining @TeX{}
 @cindex @TeX{}, how to obtain
 
@@ -16960,9 +16959,9 @@
 @cindex Pointer validation, suppressing from command line
 Suppress the pointer-validation phase of @code{makeinfo}---a dangerous
 thing to do.  This can also be done with the @code{@@novalidate}
-command (@pxref{Use TeX,,Use @TeX{}}).  Normally, consistency checks
-are made to ensure that cross references can be resolved, etc.
address@hidden Validation}.
+command (@pxref{Use TeX}).  Normally, consistency checks are made to
+ensure that cross references can be resolved, etc.  @xref{Pointer
+Validation}.
 
 @item --no-warn
 @opindex --no-warn
@@ -22052,7 +22051,7 @@
 Revision Control System}) or other version control systems, which
 expand it into a string such as:
 @example
-$Id: texinfo.txi,v 1.440 2012/04/24 17:05:41 karl Exp $
+$Id: texinfo.txi,v 1.441 2012/04/24 17:41:33 karl Exp $
 @end example
 (This is useful in all sources that use version control, not just manuals.)
 You may wish to include the @samp{$Id:} comment in the @code{@@copying}
@@ -22643,7 +22642,7 @@
 @menu
 * makeinfo Preferred::          @code{makeinfo} finds errors.
 * Debugging with Info::         How to catch errors with Info formatting.
-* Debugging with TeX::          How to catch errors with @TeX{} formatting.
+* Debugging with @TeX{}::          How to catch errors with @TeX{} formatting.
 * Using texinfo-show-structure::  How to use @code{texinfo-show-structure}.
 * Using occur::                 How to list all lines containing a pattern.
 * Running Info-Validate::       How to find badly referenced nodes.
@@ -22854,8 +22853,8 @@
 Manual}, for more address@hidden
 @end ignore
 
address@hidden Debugging with TeX
address@hidden Catching Errors with @TeX{} Formatting
address@hidden Debugging with @TeX{}
address@hidden Debugging with @TeX{}
 @cindex Catching errors with @TeX{} formatting
 @cindex Debugging with @TeX{} formatting