texinfo ChangeLog doc/texinfo.txi

[Karl Berry]

CVSROOT:        /sources/texinfo
Module name:    texinfo
Changes by:     Karl Berry <karl>       12/02/20 19:34:38

Modified files:
        .              : ChangeLog 
        doc            : texinfo.txi 

Log message:
        (texi2html): new node

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1329&r2=1.1330
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.423&r2=1.424

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1329
retrieving revision 1.1330
diff -u -b -r1.1329 -r1.1330
--- ChangeLog   20 Feb 2012 16:41:31 -0000      1.1329
+++ ChangeLog   20 Feb 2012 19:34:38 -0000      1.1330
@@ -1,5 +1,8 @@
 2012-02-20  Karl Berry  <address@hidden>
 
+       * doc/texinfo.txi (texi2html): new node, describing past,
+       present, future of texi2html.
+
        * doc/texinfo.txi (Obtaining TeX): update a bit, keep
        www.gnu.org/prep/FTP in sync.
 

Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.423
retrieving revision 1.424
diff -u -b -r1.423 -r1.424
--- doc/texinfo.txi     20 Feb 2012 16:41:32 -0000      1.423
+++ doc/texinfo.txi     20 Feb 2012 19:34:38 -0000      1.424
@@ -1,5 +1,5 @@
 \input texinfo.tex    @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.423 2012/02/20 16:41:32 karl Exp $
address@hidden $Id: texinfo.txi,v 1.424 2012/02/20 19:34:38 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.
 
@@ -619,6 +619,7 @@
                                 from a shell.
 * Pointer Validation::          How to check that pointers point somewhere.
 * Configuration Variables::     Configuring @command{texi2any}.
+* texi2html::                   Ancestor of @command{texi2any}.
 
 Configuration Variables
 
@@ -16515,6 +16516,7 @@
 * Invoking texi2any::           How to run @command{texi2any} from a shell.
 * Pointer Validation::          How to check that pointers point somewhere.
 * Configuration Variables::     Configuring @command{texi2any}.
+* texi2html::                   Ancestor of @command{texi2any}.
 @end menu
 
 
@@ -17705,16 +17707,99 @@
 @end vtable
 
 
address@hidden node texi2html
address@hidden section @command{texi2html}: Ancestor of @command{texi2any}
address@hidden pindex texi2html
address@hidden texi2html
address@hidden @command{texi2html}: Ancestor of @command{texi2any}
address@hidden texi2html
+
address@hidden Cons, Lionel
+The @command{texi2html} program is the parent of today's
address@hidden program.  It was developed independently,
+originally by Lionel Cons in 1998; at the time, @command{makeinfo}
+could not generate HTML.  Many other people contributed to
address@hidden over the years.
+
+The present @command{texi2any} supports nearly all the features of
address@hidden  However, we did not attempt to maintain strict
+compatibility, so no @command{texi2html} executable is installed by
+the Texinfo package.  The closest equivalent is an invocation like
+this (available as @file{util/texi2html} in the Texinfo source):
+
address@hidden
+texi2any --set-init-variable TEXI2HTML=1 ...
address@hidden example
+
address@hidden but, to emphasize, this is @emph{not} a drop-in replacement
+for the previous @command{texi2html}.  Here are the biggest differences:
+
address@hidden @bullet
address@hidden Most blatantly, the command line options of @command{texi2html}
+are mostly now configuration variables.  A table of approximate
+equivalents is given below.
+
address@hidden The program-level customization API is very different in
address@hidden
+
address@hidden Indices cannot be split.
+
address@hidden Translated strings cannot be customized; we hope to introduce
+this feature in @command{texi2any} in the future.
+
address@hidden itemize
+
+Aside from the last, we do not intend to reimplement these
+differences.  Therefore, the route forward for authors is alter
+manuals and build processes as necessary to use the new features and
+methods of @command{texi2any}.  The @command{texi2html} maintainers
+(one of whom is the principal author of @command{texi2any}) do not
+intend to make further releases.
+
address@hidden Options of @command{texi2html}
address@hidden Command-line options of @command{texi2html}
+Here is the table showing @command{texi2html} options and
+corresponding @command{texi2any} configuration variables
+(@pxref{texi2any Output Customization,, @command{texi2any} Output
+Customization}).
+
address@hidden address@hidden address@hidden
address@hidden @option{--toc-links}            @tab @code{TOC_LINKS}
address@hidden @option{--short-ext}            @tab @code{SHORTEXTN}
address@hidden @option{--prefix}               @tab @code{PREFIX}
address@hidden @option{--short-ref}            @tab @code{SHORT_REF}
address@hidden @option{--idx-sum}              @tab @code{IDX_SUMMARY}
address@hidden @option{--def-table}            @tab @code{DEF_TABLE}
address@hidden @option{--ignore-preamble-text} @tab @code{IGNORE_PREAMBLE_TEXT}
address@hidden @option{--html-xref-prefix}     @tab @code{EXTERNAL_DIR}
address@hidden @option{--l2h}                  @tab @code{L2H}
address@hidden @option{--l2h-l2h}              @tab @code{L2H_L2H}
address@hidden @option{--l2h-skip}             @tab @code{L2H_SKIP}
address@hidden @option{--l2h-tmp}              @tab @code{L2H_TMP}
address@hidden @option{--l2h-file}             @tab @code{L2H_FILE}
address@hidden @option{--l2h-clean}            @tab @code{L2H_CLEAN}
address@hidden @option{--use-nodes}            @tab @code{USE_NODES}
address@hidden @option{--monolithic}           @tab @code{MONOLITHIC}
address@hidden @option{--top-file}             @tab @code{TOP_FILE}
address@hidden @option{--toc-file}             @tab @code{TOC_FILE}
address@hidden @option{--frames}               @tab @code{FRAMES}
address@hidden @option{--menu}                 @tab @code{SHOW_MENU}
address@hidden @option{--debug}                @tab @code{DEBUG}
address@hidden @option{--doctype}              @tab @code{DOCTYPE}
address@hidden @option{--frameset-doctype}     @tab @code{FRAMESET_DOCTYPE}
address@hidden @option{--test}                 @tab @code{TEST}
address@hidden multitable
+
address@hidden @file{texi2oldapi.texi}, for @command{texi2any}
+Finally, any @command{texi2html} users seeking more detailed
+information can check the draft file @file{doc/texi2oldapi.texi} in
+the Texinfo source repository.  It consists mainly of very rough
+notes, but may still be useful to some.
 
 
 @node Creating and Installing Info Files
 @chapter Creating and Installing Info Files
 
-This chapter describes how to create and install Info files.  @xref{Info
-Files}, for general information about the file format itself.
+This chapter describes how to create and install Info files.
address@hidden Files}, for general information about the file format
+itself.
 
 @menu
 * Creating an Info File::
@@ -21673,7 +21758,7 @@
 Revision Control System}) or other version control systems, which
 expand it into a string such as:
 @example
-$Id: texinfo.txi,v 1.423 2012/02/20 16:41:32 karl Exp $
+$Id: texinfo.txi,v 1.424 2012/02/20 19:34:38 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}