texinfo ChangeLog doc/texinfo.txi

[karl]

CVSROOT:        /sources/texinfo
Module name:    texinfo
Changes by:     karl <karl>     12/09/10 23:24:12

Modified files:
        .              : ChangeLog 
        doc            : texinfo.txi 

Log message:
        mention txixml2texi

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1415&r2=1.1416
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.476&r2=1.477

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1415
retrieving revision 1.1416
diff -u -b -r1.1415 -r1.1416
--- ChangeLog   10 Sep 2012 19:32:52 -0000      1.1415
+++ ChangeLog   10 Sep 2012 23:24:12 -0000      1.1416
@@ -4,6 +4,8 @@
 
 2012-09-10  Karl Berry  <address@hidden>
 
+       * doc/texinfo.txi (Overview): mention txixml2texi.
+
        * doc/texinfo.txi (Functions Commands): recommend @code rather
        than @var to avoid en-dashes and em-dashes (and Spanish ligatures)
        in formal parameter names containing 2+ hyphens.

Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.476
retrieving revision 1.477
diff -u -b -r1.476 -r1.477
--- doc/texinfo.txi     10 Sep 2012 18:45:44 -0000      1.476
+++ doc/texinfo.txi     10 Sep 2012 23:24:12 -0000      1.477
@@ -1,5 +1,5 @@
 \input texinfo.tex    @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.476 2012/09/10 18:45:44 karl Exp $
address@hidden $Id: texinfo.txi,v 1.477 2012/09/10 23:24:12 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.
 
@@ -885,13 +885,14 @@
 @cindex Introduction to Texinfo
 
 Using Texinfo, you can create a printed document (via the @TeX{}
-typesetting system) with the normal features of a book, including chapters,
-sections, cross references, and indices.  From the same Texinfo source
-file, you can create an Info file with special features to make
-documentation browsing easy.  You can also create from that same
-source file an HTML output file suitable for use with a web browser,
-or an XML file.  See the next section (@pxref{Output Formats}) for
-details and sample commands to generate output from the source.
+typesetting system) with the normal features of a book, including
+chapters, sections, cross references, and indices.  From the same
+Texinfo source file, you can create an Info file with special features
+to make documentation browsing easy.  You can also create from that
+same source file an HTML output file suitable for use with a web
+browser, a Docbook file, or a transliteration in XML format.  See the
+next section (@pxref{Output Formats}) for details and sample commands
+to generate output from the source.
 
 @TeX{} works with virtually all printers; Info works with virtually
 all computer terminals; the HTML output works with virtually all web
@@ -963,10 +964,9 @@
 printed, notably Dvips for translation to PostScript (@pxref{Top,,,
 dvips, Dvips}) and Xdvi for viewing on an X display
 (@uref{http://sourceforge.net/projects/xdvi/}).  @xref{Hardcopy}.
-
-Be aware that the Texinfo language is very different from and much
+(Be aware that the Texinfo language is very different from and much
 stricter than @TeX{}'s usual languages: plain @TeX{}, @LaTeX{},
address@hidden, etc.
address@hidden, etc.)
 
 @item PostScript
 @cindex PostScript output, overview
@@ -1007,15 +1007,19 @@
 @cindex Texinfo XML output, overview
 @cindex DTD, for Texinfo XML
 @pindex texinfo.dtd
address@hidden txixml2texi
 (Generated via @command{makeinfo --xml}.)  XML is a generic syntax
-specification usable for any sort of content (see, for example,
+specification usable for any sort of content (a reference is at
 @uref{http://www.w3.org/XML}).  The @command{makeinfo} XML output,
-unlike all the other output formats, interprets very little of the
-Texinfo source.  Rather, it translates the Texinfo markup commands
-into XML syntax, for processing by further XML tools.  The details of
-the output are defined in an XML DTD as usual, which is contained in a
-file @file{texinfo.dtd} included in the Texinfo source distribution
-and available via the Texinfo web pages.
+unlike all the other output formats, is a transliteration of the
+Texinfo source rather than processed output.  That is, it translates
+the Texinfo markup commands into XML syntax, for further processing by
+XML tools.  The details of the output are defined in an XML DTD as
+usual, which is contained in a file @file{texinfo.dtd} included in the
+Texinfo source distribution and available via the Texinfo web pages.
+The XML contains enough information to (nearly) recreate the original
+source, and the Texinfo sources include a utility script
address@hidden to do just that.
 @end table
 
 
@@ -21836,7 +21840,7 @@
 or other version control systems, which expand it into a string such
 as:
 @example
-$Id: texinfo.txi,v 1.476 2012/09/10 18:45:44 karl Exp $
+$Id: texinfo.txi,v 1.477 2012/09/10 23:24:12 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}