Manual Pages for UNIX Darwin command on man texi2html

TEXI2HTML(1) TEXI2HTML(1)

NAME

texi2html - a Texinfo to HTML converter

SYNOPSIS

tteexxii22hhttmmll [[ooppttiioonnss]] ffiillee

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 --ll22hh 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.

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

--hheellpp [[11||22]]

Print usage instructions and list the most important, all

relevant, or all recognised (including obsolete) command-

line options, and exit.

--iiffiinnffoo --iifftteexx --iiffxxmmll --iiffppllaaiinntteexxtt --iiffhhttmmll

Expand @ifinfo, @iftex and @tex, @ifxml and @xml, @ifplain-

text, @ifhtml and @html regions, and don't expand @ifnot corresponding regions (default: ifhtml).

--nnoo-iiffiinnffoo --nnoo-iifftteexx --nnoo-iiffxxmmll --nnoo-iiffppllaaiinntteexxtt --nnoo-hhttmmll

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

-II dir Append dir to the directory list searched for included

files.

-PP dir Prepend dir to the directory list searched for included

files.

--nnoo-mmeennuu Don't show the Texinfo menus; by default they are shown.

--nnoo-nnuummbbeerr Don't number the sections.

--sspplliitt cchhaapptteerr||sseeccttiioonn||nnooddee

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

--ll22hh 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.

--ll22hh-ll22hh prog

Use prog as latex2html program (default latex2html). Pro-

gram must be executable.

--ll22hh-iinniitt 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.

--ll22hh-ttmmpp dir

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

--ll22hh-cclleeaann remove all intermediate files generated by latex2html (pre-

vents caching!)

--ll22hh-sskkiipp Do not really run latex2html. Use (kept) files of previous

runs, instead.

--VVeerrbboossee Give a verbose output.

--vveerrssiioonn 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): ffoooottoocc..hhttmmll The table of contents (if @contents is present). ffoooo..hhttmmll The document's contents or the Top element. ffooooffoott..hhttmmll The footnotes (if any). ffooooaabbtt..hhttmmll An help section. ffooooll22hhiimmgg** Images generated by latex2html (if any).

When used with the --sspplliitt option, it creates several files (one per

chapter or node), named ffoooonn..hhttmmll (n being the index of the chapter or node), and the ffoooo..hhttmmll file contains the Top element. Otherwise it creates only one file: ffoooo..hhttmmll VVEERRSSIIOONN

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/

the GNU General Public License. For more information about these mat-

ters, see the file named COPYING.

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)