texi2html(1)							  texi2html(1)

NAME

       texi/ - a Texinfo to HTML converter

SYNOPSIS

       texi/ [options] file

       texi/ -check [-verbose] files

DESCRIPTION

       Texi/  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...

       It  also tries to add links from a reference to its corresponding entry
       in the bibliography (if any). It may also handle a  glossary  (see  the
       -glossary option).

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

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

       The  HTML  files	 created  by texi/ are closer to TeX than to Info,
       that's why

OPTIONS

       -check	   Check the given file and give the list of all  things  that
		   may	be  Texinfo  commands.	 This may be used to check the
		   output of texi/ to find the Texinfo commands that  have
		   been left in the HTML file.

       -expandinfo Expand @ifinfo sections, not @iftex ones.

       -glossary   Use	the  section named 'Glossary' to build a list of terms
		   and put links in the HTML document from  each  term	toward
		   its definition.

       -invisible name
		   Use	name to create invisible destination anchors for index
		   links (you can for  instance	 use  the  invisible.xbm  file
		   shipped  with  this	program).   This is a workaround for a
		   known bug of many WWW browsers, including netscape.

       -I dir	   Look also in dir to find included files.

       -menu	   Show the Texinfo menus; by default they are ignored.

       -monolithic Output only one file, including the table of	 contents  and
		   footnotes.

       -number	   Number the sections.

       -split_chapter
		   Split the output into several HTML files (one per main sec-
		   tion: chapter, appendix...).

       -split_node Split the output into several HTML files (one per node).

       -l2h	   Use latex/ 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_latex/ prog
		   Use prog as latex/ program (default latex/).	  Pro-
		   gram must be executable.

       -l2h_init file
		   Use	file  as  latex/ init file. file should be used to
		   specify  in	which  way  latex/	handles	  mathematical
		   expressions and formulas.

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

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

       -l2h_keep   Keep	 temporary  files  which   were	  generated   to   run
		   latex/.

       -l2h_skip   Do  not really run latex/. Use (kept) files of previous
		   runs, instead.

       -usage	   Print usage instructions,  listing  the  current  available
		   command-line options.

       -verbose	   Give	 a verbose output. Can be used with the -check option.

FILES

       By default texi/ creates the following files (foo being the name of
       the Texinfo file):

       foo_toc/    The table of contents.

       foo/	       The document's contents.

       foo_foot/   The footnotes (if any).

       foo_l2h_img*    Images generated by latex/ (if any).

       When  used  with	 the  -split option, it creates several files (one per
       chapter or node), named foo_n/ (n being the index of the chapter or
       node), instead of the single foo/ file.

       When  used  with	 the  -monolithic  option,  it	creates only one file:
       foo/

VARIABLES

       texi/ predefines the following variables: , texi/.

       texi/ implements the following non-Texinfo commands (maybe they are
       in Texinfo now...):

       @i/	       This  indicates the start of an HTML section, this sec-
		       tion will passed through without any modification.

       @end i/     This indicates the end of an HTML section.

       This is texi/ version 1.56k, 1999-02-20.

       The latest version of texi/ and latex2/can be found in WWW, cf.
       URLs http://wwwinfo.cern.ch/dis/texi//
       http://texinfo.org/texi/
       http://www-dsed.llnl.gov/files/programs/unix/latex/

       The  main  author is Lionel Cons, CERN IT/DIS/OSE, Lionel.Cons@cern.ch.
       Many other people around the net contributed to this program.

       This program is the intellectual property of  the  European  Laboratory
       for  Particle  Physics (known as CERN). No guarantee whatsoever is pro-
       vided by CERN. No liability whatsoever is accepted for any loss or dam-
       age  of any kind resulting from any defect or inaccuracy in this infor-
       mation or code.

       CERN, 1211 Geneva 23, Switzerland

       GNU Texinfo Documentation Format,  HyperText  Markup  Language  (HTML),
       World Wide Web (WWW).

       This program does not understand all Texinfo commands (yet). A row of a
       mutlicolumn table has to be in one line.

       TeX specific commands (normally enclosed in @iftex) will be passed over
       unmodified, unless latex/ is enabled.



7th Edition			   01/05/98			  texi2html(1)