texinfo ChangeLog NEWS doc/texinfo.txi

[Karl Berry]

CVSROOT:        /sources/texinfo
Module name:    texinfo
Changes by:     Karl Berry <karl>       10/07/25 00:24:53

Modified files:
        .              : ChangeLog NEWS 
        doc            : texinfo.txi 

Log message:
        texi2any edit/proofread start

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1071&r2=1.1072
http://cvs.savannah.gnu.org/viewcvs/texinfo/NEWS?cvsroot=texinfo&r1=1.195&r2=1.196
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.265&r2=1.266

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1071
retrieving revision 1.1072
diff -u -b -r1.1071 -r1.1072
--- ChangeLog   24 Jul 2010 21:14:38 -0000      1.1071
+++ ChangeLog   25 Jul 2010 00:24:52 -0000      1.1072
@@ -1,3 +1,8 @@
+2010-07-24  Karl Berry  <address@hidden>
+
+       * doc/texinfo.txi (Generic translator texi2any/makeinfo): rename
+       from "Generic converter", edit chapter intro.
+
 2010-07-24  Patrice Dumas  <address@hidden>
 
        * doc/texinfo.txi (Initialization files basics): merge `Function 

Index: NEWS
===================================================================
RCS file: /sources/texinfo/texinfo/NEWS,v
retrieving revision 1.195
retrieving revision 1.196
diff -u -b -r1.195 -r1.196
--- NEWS        18 Jul 2010 18:49:02 -0000      1.195
+++ NEWS        25 Jul 2010 00:24:52 -0000      1.196
@@ -1,4 +1,4 @@
-$Id: NEWS,v 1.195 2010/07/18 18:49:02 karl Exp $
+$Id: NEWS,v 1.196 2010/07/25 00:24:52 karl Exp $
 This NEWS file records noteworthy changes, very tersely.
 See the manual for detailed information.
 
@@ -32,8 +32,9 @@
   . DEL (0x7f = 0177 = 127) is a true comment character (catcode 14 in TeX).
 
 * texi2html:
-  . new program, replacing and upward-compatible with makeinfo, but
-    with many additional features.  See texi2html/NEWS for its own changes.
+  . new program, replacing and upward-compatible with makeinfo,
+    with many additional features.  Cross-manual references are now
+    fully supported, for one.  See texi2html/NEWS for its own changes.    
 
 * texinfo.tex:
   . support some per-language hyphenation, when the underlying TeX
@@ -41,6 +42,10 @@
     later).  Words with accented letters are still not handled properly.
   . new Icelandic translation: txi-is.tex.
 
+* texi2any: 
+  . new generic converter that can produce all supported output formats,
+    both those from texi2dvi (PDF/DVI) and from makeinfo (Info/HTML/etc.).
+
 * texi2dvi:
   . new option --max-iterations.
   

Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.265
retrieving revision 1.266
diff -u -b -r1.265 -r1.266
--- doc/texinfo.txi     24 Jul 2010 21:14:38 -0000      1.265
+++ doc/texinfo.txi     25 Jul 2010 00:24:53 -0000      1.266
@@ -1,5 +1,5 @@
 \input texinfo.tex    @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.265 2010/07/24 21:14:38 pertusus Exp $
address@hidden $Id: texinfo.txi,v 1.266 2010/07/25 00:24:53 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.
 
@@ -160,7 +160,7 @@
 * Defining New Texinfo Commands:: User-defined macros and aliases.
 * Include Files::                 How to incorporate other Texinfo files.
 * Hardcopy::                            Output for paper, with @TeX{}.
-* Generic converter texi2any/makeinfo:: The all purpose converter.
+* Generic translator texi2any/makeinfo:: The all purpose converter.
 * Creating and Installing Info Files::  Details on Info output.
 * Generating HTML::               Details on HTML output.
 * texi2any output customization:: Fine tuning with initialization files.
@@ -601,7 +601,7 @@
 * PDF Output::                  Portable Document Format output.
 * Obtaining TeX::               How to Obtain @TeX{}.
 
-Generic converter texi2any/makeinfo
+Generic translator texi2any/makeinfo
 
 * Invoking texi2any::           How to run @command{texi2any} and 
@command{makeinfo} 
                                 from a shell.
@@ -3212,7 +3212,7 @@
 You may wish to include titlepage-like information for plain text
 output.  Simply place any such leading material between
 @code{@@ifplaintext} and @code{@@end ifplaintext}; @command{makeinfo}
-includes this when writing plain text (@samp{--plaintext}), along with
+includes this when generating plain text (@samp{--plaintext}), along with
 an @code{@@insertcopying}.
 
 @menu
@@ -5184,9 +5184,9 @@
 The node to which a pointer points may come before or after the
 node containing the pointer.
 
address@hidden
 @cindex @@-commands in nodename
 @cindex Node name, should not contain @@-commands
address@hidden
 @@-commands in node names are not allowed.  This includes punctuation
 characters that are escaped with a @samp{@@}, such as @code{@@} and
 @address@hidden, and accent commands such as @samp{@@'}.  Perhaps
@@ -15918,32 +15918,44 @@
 Many other @TeX{} distributions are available; see
 @uref{http://tug.org/}.
 
address@hidden Generic converter texi2any/makeinfo
address@hidden A generic converter for Texinfo: 
@command{texi2any}/@command{makeinfo}
 
address@hidden is a generic converter for Texinfo that can produce
-different output formats and is highly customizable. 
-By default, the formats that may be produced are 
-Info (with @option{--info}), HTML (with
address@hidden), plain text (with @option{--plaintext}), Docbook 
-(with @option{--docbook}), Texinfo XML (with @option{--xml}). 
address@hidden is an alias of @command{texi2any}, and using this command
-is the same as using @code{texi2any --info}.
-
-Without any command line option, @command{texi2any} generates raw text with
-minimal formatting, well suited for customization. It is not advised to
-use this output format to generate documents, however, since it is 
-very basic. You should produce plain text instead, with 
address@hidden Generic translator texi2any/makeinfo
address@hidden A generic translator for Texinfo: 
@command{texi2any}/@command{makeinfo}
+
address@hidden is a generic translator for Texinfo that can
+produce different output formats and is highly customizable.  By
+default, the formats that may be produced are:
+
address@hidden @asis
address@hidden Info (with @option{--info}),
+
address@hidden HTML (with @option{--html}),
+
address@hidden plain text (with @option{--plaintext}),
+
address@hidden Docbook (with @option{--docbook}),
+
address@hidden Texinfo XML (with @option{--xml}).
address@hidden table
+
address@hidden is an alias of @command{texi2any}, and using this
+command is the same as using @code{texi2any --info}.
+
+Without any command line option, @command{texi2any} generates raw text
+with minimal formatting, which may be suitable for further processing.
+We do not recommend using this output format for actual documentation,
+since it is so basic.  Instead, produce plain text with
 @option{--plaintext}.
 
-Beside those default formats, with @command{texi2any} some important
-aspects of the result may be specified via command line options,
-and initialization files provide an even finer degree of control
-over the final output, allowing most every aspect of the final output not
-specified in the Texinfo input file to be specified.  Initialization files are
-written in @command{perl}, like the main program, and anything which may be
-specified on the command line may also be specified within a initialization
-file.
+Beside these default formats, command line options to
address@hidden can determine important aspects of the output.
+Beyond that, initialization files provide an even finer degree of
+control over the final output, including nearly every aspect not
+specified in the Texinfo input file.  Initialization files are written
+in Perl, like the main program, and anything which may be specified on
+the command line may also be specified within a initialization file.
+
+The rest of this chapter gives further details on the program.
 
 @menu
 * Invoking texi2any::           How to run @command{texi2any} or 
@command{makeinfo} 
@@ -15952,6 +15964,7 @@
 * makeinfo Configuration Variables:: Description of configuration variables.
 @end menu
 
+
 @node Invoking texi2any
 @section Running @command{texi2any}/@code{makeinfo} from a Shell
 @pindex makeinfo
@@ -23674,7 +23687,7 @@
 (@url{http://www.gnu.org/software/rcs}) version control systems, which
 expand it into a string such as:
 @example
-$Id: texinfo.txi,v 1.265 2010/07/24 21:14:38 pertusus Exp $
+$Id: texinfo.txi,v 1.266 2010/07/25 00:24:53 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}
@@ -23753,7 +23766,7 @@
 
 @verbatim
 \input texinfo   @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.265 2010/07/24 21:14:38 pertusus Exp $
address@hidden $Id: texinfo.txi,v 1.266 2010/07/25 00:24:53 karl Exp $
 @comment %**start of header
 @setfilename sample.info
 @include version.texi