TEXI2HTML(1)                                                      TEXI2HTML(1)



NAME
       texi2html - a Texinfo to HTML converter

SYNOPSIS
       texi2html [options] file

DESCRIPTION
       Texi2html  converts  the  given Texinfo file to a set of HTML files. It
       tries to handle most of the  Texinfo  commands.  It  creates  hypertext
       links for cross-references, footnotes...

       Texi2html  may furthermore use latex2html to generate HTML (code and/or
       images) for @math and @iftex tags (see the --l2h option).

       Texi2html creates several files depending on the contents of  the  Tex-
       info file and on the chosen options (see FILES).

       The HTML files created by texi2html are closer to TeX than to Info.

OPTIONS
       Options may be abbreviated to th shortests unique prefix. The following
       is only an incomplete list of the available options:

       --help [12]
                   Print usage instructions and list the most  important,  all
                   relevant,  or  all recognised (including obsolete) command-
                   line options, and exit.

       --ifinfo --iftex --ifxml --ifplaintext --ifhtml
                   Expand @ifinfo, @iftex and @tex, @ifxml and @xml, @ifplain-
                   text,  @ifhtml  and  @html regions, and don't expand @ifnot
                   corresponding regions (default: ifhtml).

       --no-ifinfo --no-iftex --no-ifxml --no-ifplaintext --no-html
                   Don't expand @ifinfo, @iftex, @ifxml, @ifplaintext  regions
                   and expand @ifnot corresponding regions.

       -I dir      Append  dir  to  the  directory  list searched for included
                   files.

       -P dir      Prepend dir to the directory  list  searched  for  included
                   files.

       --no-menu   Don't show the Texinfo menus; by default they are shown.

       --no-number Don't number the sections.

       --split chaptersectionnode
                   Split  the  output  into  several  HTML files (one per main
                   chapter/section or node).

       --l2h       Use latex2html for content of @math and @tex tags.  Content
                   must  be  such  that  both, latex and tex, can translate it
                   correctly. I.e., no tex-only constructs must be used.

       --l2h-l2h prog
                   Use prog as latex2html program (default latex2html).   Pro-
                   gram must be executable.

       --l2h-init file
                   Use  file  as  latex2html init file. file should be used to
                   specify  in  which  way  latex2html  handles   mathematical
                   expressions and formulas.

                   Note  that  latex2html locates (and uses) init-files in the
                   following order (provided they exist): (1) global init file
                   (usually      in     latex2html     source     dir)     (2)
                   $HOME/.latex2htmlinit (3) ./.latex2htmlinit (4) init file
                   given on command line.

       --l2h-tmp dir
                   Use  dir  as  tmp dir for latex2html. This directory (resp.
                   its path) must not contain a dot  (i.e., a ".").

       --l2h-clean remove all intermediate files generated by latex2html (pre-
                   vents caching!)

       --l2h-skip  Do  not really run latex2html. Use (kept) files of previous
                   runs, instead.

       --Verbose   Give a verbose output.

       --version   Print version and exit.


FILES
       Initialisation options are read first from ${prefix}/etc/texi2html/Con-
       fig  (the  exact  location  being  changeable with the --sysconfdir=dir
       option to the configure  script),  then  from  $HOME/.texi2html/Config,
       then any command-line options including --init-file options; with later
       settings overriding earlier ones.

       By default texi2html my creates the following files (foo being the name
       of the Texinfo file):

       footoc.html    The table of contents (if @contents is present).

       foo.html        The document's contents or the Top element.

       foofot.html    The footnotes (if any).

       fooabt.html    An help section.

       fool2himg**    Images generated by latex2html (if any).

       When  used  with  the --split option, it creates several files (one per
       chapter or node), named foon.html (n being the index of the chapter or
       node), and the foo.html file contains the Top element.

       Otherwise it creates only one file: foo.html

VERSION
       This is texi2html version 1.70, 24 March 2004.

AUTHOR
       Texi2html  was  originally  written by is Lionel Cons, CERN IT/DIS/OSE,
       Lionel.Cons@cern.ch.  Over time, many other people around the net  con-
       tributed  to  this  program.   Its current maintainer is Olaf Bachmann,
       obachman@mathematik.uni-kl.de.

AVAILABILITY
       The latest version of this program, as well as support in the  form  of
       mailing  lists  with  archives,  bug tracking, documentation, and other
       tools can be found at:       http:/texi2html.cvshome.org/

COPYRIGHT
       Copyright (C) 1999, 2000, 2003  Free Software Foundation,  Inc.   There
       is  NO warranty.  You may redistribute this software under the terms of
       the GNU General Public License.  For more information about these  mat-
       ters, see the file named COPYING.

SEE ALSO
       GNU Texinfo Documentation Format
       http:/texinfo.org/
       World Wide Web (W), HyperText Markup Language (HTML)
       http:/www.w3.org
       LaTeX2HTML
       http:/www-dsed.llnl.gov/files/programs/unix/latex2html

BUGS
       This man-page is not up-to-date and there exists no up-to-date documen-
       tation, yet.  Until it exists, see the beginning of the  texi2html.init
       file for remarks about command-line options and configurations.



7th Edition                      24 March 2004                    TEXI2HTML(1)