texinfo ChangeLog doc/texinfo.txi

[karl]

CVSROOT:        /sources/texinfo
Module name:    texinfo
Changes by:     karl <karl>     12/09/15 15:53:08

Modified files:
        .              : ChangeLog 
        doc            : texinfo.txi 

Log message:
        more progress toward @code in node names

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1422&r2=1.1423
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.482&r2=1.483

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1422
retrieving revision 1.1423
diff -u -b -r1.1422 -r1.1423
--- ChangeLog   14 Sep 2012 18:18:05 -0000      1.1422
+++ ChangeLog   15 Sep 2012 15:53:07 -0000      1.1423
@@ -1,3 +1,9 @@
+2012-09-15  Karl Berry  <address@hidden>
+
+       * doc/texinfo.txi (Print with @code{lpr}),
+       (Format with @code{texi2dvi}),
+       (@code{@@pagesizes}): use @code in node names.
+
 2012-09-14  Karl Berry  <address@hidden>
 
        * doc/texinfo.txi (Inline Conditionals): rename from Inline

Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.482
retrieving revision 1.483
diff -u -b -r1.482 -r1.483
--- doc/texinfo.txi     14 Sep 2012 18:18:06 -0000      1.482
+++ doc/texinfo.txi     15 Sep 2012 15:53:07 -0000      1.483
@@ -1,5 +1,5 @@
 \input texinfo.tex    @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.482 2012/09/14 18:18:06 karl Exp $
address@hidden $Id: texinfo.txi,v 1.483 2012/09/15 15:53:07 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.
 
@@ -582,9 +582,9 @@
 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.
-* Print with lpr::              How to print.
+* Format with @code{tex}/@code{texindex}:: How to format with explicit shell 
commands.
+* Format with @code{texi2dvi}::      A simpler way to format.
+* Print with @code{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.
 * Compile-Command::             How to print using Emacs's compile command.
@@ -593,7 +593,7 @@
 * 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.
-* pagesizes::                   How to print with customized page sizes.
+* @code{@@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.
@@ -2555,13 +2555,14 @@
 @cindex Buffer formatting and printing
 @cindex Part of file formatting and printing
 
-Typesetting and printing a Texinfo file is a multi-step process in which
-you first create a file for printing (called a DVI file), and then
-print the file.  Optionally, you may also create indices.  To do this,
-you must run the @code{texindex} command after first running the
+Typesetting and printing a Texinfo file is a multi-step process in
+which you first create a file for printing (called a DVI file), and
+then print the file.  Optionally, you may also create indices.  To do
+this, 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{Format with
address@hidden).
 
 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
@@ -3699,8 +3700,8 @@
 You need to include the @code{@@address@hidden
 commands early in the document (just after @code{@@setfilename}, for
 example).  We recommend using @command{texi2dvi} (@pxref{Format with
-texi2dvi}) to specify this without altering the source file at all.
-For example:
address@hidden) to specify this without altering the source file at
+all.  For example:
 
 @example
 texi2dvi --texinfo=@@setcontentsaftertitlepage foo.texi
@@ -13420,8 +13421,8 @@
 itself, but will often be the case for recent distributions of
 extended @TeX{} programs @command{etex} (DVI output) and
 @command{pdftex} (PDF output), such as @TeX{} Live 2008.
address@hidden will use the extended @TeX{}s if they are
-available (@pxref{Format with texi2dvi}).
address@hidden will use the extended @TeX{}s if they are available
+(@pxref{Format with @code{texi2dvi}}).
 
 In September 2006, the W3C Internationalization Activity released a
 new recommendation for specifying languages:
@@ -14665,9 +14666,9 @@
 macro-related errors when producing the printed version of a manual,
 you might try expanding the macros with @command{makeinfo} by invoking
 @command{texi2dvi} with the @samp{-E} option (@pxref{Format with
-texi2dvi}).  Or eschew Texinfo macros altogether and use a language
-designed for macro processing, such as M4 (@pxref{External Macro
-Processors}).
address@hidden).  Or eschew Texinfo macros altogether and use a
+language designed for macro processing, such as M4 (@pxref{External
+Macro Processors}).
 
 @itemize @bullet
 @item
@@ -15048,9 +15049,9 @@
 @itemize @bullet
 @item
 If you run @command{texi2dvi} or its variants (@pxref{Format with
-texi2dvi,, Format with @code{texi2dvi}}), you can pass @option{-E} and
address@hidden will run @command{makeinfo} first to expand macros
-and eliminate @samp{#line}.
address@hidden), you can pass @option{-E} and @command{texi2dvi}
+will run @command{makeinfo} first to expand macros and eliminate
address@hidden
 
 @item
 If you run @command{makeinfo} or its variants (@pxref{Generic
@@ -15410,9 +15411,9 @@
 
 @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.
-* Print with lpr::              How to print.
+* Format with @code{tex}/@code{texindex}:: How to format with explicit shell 
commands.
+* Format with @code{texi2dvi}::      A simpler way to format.
+* Print with @code{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.
 * Compile-Command::             How to print using Emacs's compile command.
@@ -15421,7 +15422,7 @@
 * 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.
-* pagesizes::                   How to print with customized page sizes.
+* @code{@@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.
@@ -15440,7 +15441,7 @@
 itself.
 
 
address@hidden Format with tex/texindex
address@hidden Format with @code{tex}/@code{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}
@@ -15539,7 +15540,7 @@
 
 @pindex texi2dvi
 Alternatively, it's a one-step process: run @code{texi2dvi}
-(@pxref{Format with texi2dvi}).
+(@pxref{Format with @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
@@ -15571,7 +15572,7 @@
 (@pxref{Pointer Validation}).
 
 
address@hidden Format with texi2dvi
address@hidden Format with @code{texi2dvi}
 @section Format with @code{texi2dvi}
 @pindex texi2dvi @r{(shell script)}
 
@@ -15602,9 +15603,9 @@
 running @TeX{}.  With this, you can specify different printing
 formats, such as @code{@@smallbook} (@pxref{smallbook}),
 @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{}}).
+(@address@hidden@@pagesizes}}), without actually changing the document
+source.  (You can also do this on a site-wide basis with
address@hidden; @pxref{Preparing for @TeX{}}).
 
 @opindex address@hidden, for @command{texi2dvi}}
 @pindex pdftexi2dvi
@@ -15690,8 +15691,8 @@
 For the list of all options, run @samp{texi2dvi --help}.
 
 
address@hidden Print with lpr
address@hidden Shell Print Using @code{lpr -d}
address@hidden Print with @code{lpr}
address@hidden Print With @code{lpr -d} From Shell
 @pindex lpr @r{(DVI print command)}
 
 The precise command to print a DVI file depends on your system
@@ -16211,9 +16212,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{}}, for other
-ways to format with @code{@@smallbook} that do not require changing
-the source file.
address@hidden with @code{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
@@ -16241,9 +16242,9 @@
 @end group
 @end example
 
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.
address@hidden with @code{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
@@ -16251,8 +16252,11 @@
 @code{@@afourlatex}.  There's also @code{@@afourwide} for A4 paper in
 wide format.
 
address@hidden pagesizes
+
address@hidden @code{@@pagesizes}
 @section @code{@@pagesizes} address@hidden, @var{height}]: Custom Page Sizes
+
address@hidden@c old node name
 @findex pagesizes
 @cindex Custom page sizes
 @cindex Page sizes, customized
@@ -16287,9 +16291,9 @@
 margins, you must define a new command in @file{texinfo.tex} or
 @file{texinfo.cnf}.
 
address@hidden with texi2dvi}, and @ref{Preparing for @TeX{}}, for other
-ways to specify @code{@@pagesizes} that do not require changing the
-source file.
address@hidden with @code{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}.
 
@@ -16363,10 +16367,10 @@
 The simplest way to generate PDF output from Texinfo source is to run
 the convenience script @command{texi2pdf} (or @command{pdftexi2dvi});
 this executes the @command{texi2dvi} script with the @option{--pdf}
-option (@pxref{Format with texi2dvi}).  If for some reason you want to
-process the document by hand, you can run the @command{pdftex} program
-instead of plain @command{tex}.  That is, run @samp{pdftex foo.texi}
-instead of @samp{tex foo.texi}.
+option (@pxref{Format with @code{texi2dvi}}).  If for some reason you
+want to process the document by hand, you can run the @command{pdftex}
+program instead of plain @command{tex}.  That is, run @samp{pdftex
+foo.texi} instead of @samp{tex foo.texi}.
 
 @dfn{PDF} stands for `Portable Document Format'. It was invented by
 Adobe Systems some years ago for document interchange, based on their
@@ -17033,7 +17037,7 @@
 
 The output format options for this are @option{--dvi},
 @option{--dvipdf}, @option{--pdf}, and @option{--pdf}.  @xref{Format
-with texi2dvi}, for more details on these options and general
+with @code{texi2dvi}}, for more details on these options and general
 @command{texi2dvi} operation.  In addition, the @option{--verbose},
 @option{--silent}, and @option{--quiet} options are passed on if
 specified; the @option{-I} and @option{-o} options are likewise passed
@@ -21938,7 +21942,7 @@
 or other version control systems, which expand it into a string such
 as:
 @example
-$Id: texinfo.txi,v 1.482 2012/09/14 18:18:06 karl Exp $
+$Id: texinfo.txi,v 1.483 2012/09/15 15:53:07 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}