Command Line Options
********************

Debugging
=========

-debug

debugging: 0 --- no debugging; other values; see beginning of texi2html

$DEBUG_TOC   =  1;
$DEBUG_INDEX =  2;
$DEBUG_BIB   =  4;
$DEBUG_GLOSS =  8;
$DEBUG_DEF   = 16;
$DEBUG_HTML  = 32;
$DEBUG_USER  = 64;
$DEBUG_L2H   = 128;

DocType
=======

-doctype

     <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

Check
=====

-check if set, only check files and give the list of all things that look like untranslated Texinfo commands

Expand
======

-expand if set to tex (or, info) expand @iftex and @tex (or, @ifinfo) sections else, neither expand @iftex, @tex, nor @ifinfo sections

Glossary
========

-glossary if set, uses section named Footnotes for glossary

Invisible
=========

-invisible $T2H_INVISIBLE_MARK is the text used 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. For me, it works fine without it --- on the contrary: if there, it inserts space between headers and start of text (obachman 3/99)

     $T2H_INVISIBLE_MARK = "";
     # $T2H_INVISIBLE_MARK = '&#160;';

Iso
===

-iso

if set, ISO8859 characters are used for special symbols (like Copyright ©, etc)

$T2H_USE_ISO = 0;

Include Directory
=================

-I

list directories where @include files are searched for (besides the directory of the doc file) additional -I args are add to this list.

@T2H_INCLUDE_DIRS = (".");

Top File
========

-top_file uses file of this name for top-level file extension is manipulated appropriately, if necessary. If empty, <basename of document>.html is used. Typically, you would set this to index.html.

$T2H_TOP_FILE = "";

Table Of content File
=====================

-toc_file uses file of this name for table of contents.  File extension is manipulated appropriately, if necessary. If empty, <basename of document>_toc.html is used.

$T2H_TOC_FILE = "";

Frames
======

-frames if set, output two additional files which use HTML 4.0 frames.

$T2H_FRAMES = 0;

Menus
=====

-menu or -nomenu if set, show the Texinfo menus

$T2H_SHOW_MENU = 1;

Number sections
===============

-number -nonumber if set, number sections and show section names and numbers in references and menus

Split
=====

-split section|chapter|none if set to section (resp. chapter) create one HTML file per (sub)section (resp. chapter) and separate pages for Top, ToC, Overview, Index, Glossary, About.  Otherwise, create a monolithic HTML file that contains the whole document.

#$T2H_SPLIT = 'section'; $T2H_SPLIT = undef;

Section navigation
==================

-section_navigation| -no-section_navigation

if set, then navigation panels are printed at the beginning of each section and, possibly at the end (depending on whether or not there were more than $T2H_WORDS_IN_PAGE words on page). This is most useful if you do not want to have section navigation on -split chapter

Subdirectory
============

-subdir If set, then put result files in the specified directory. If not set, then result files are put into current directory.

$T2H_SUBDIR = undef;

Short extension
===============

-short_extn If this is set, then all HTML files will have extension .htm instead of .html. This is helpful when shipping the document to DOS-based systems. $T2H_SHORTEXTN = 0;

Prefix
======

-prefix Set the output file prefix, prepended to all .html, .gif and .pl files. By default, this is the basename of the document

$T2H_PREFIX = "";

Output filename
===============

-o filename|-out_file If set, generate monolithic document output HTML into filename.

Short Cross References
======================

-short_ref if set cross-references are given without section numbers

Index Summary
=============

-idx_sum If value is set, then for each @prinindex $what $docu_name_$what.idx is created which contains lines of the form $key\t$ref sorted alphabetically (case matters).

Verbose output
==============

-verbose if set, chatter about what we are doing.

Language Support
================

-lang For page titles, use $T2H_WORDS->{$T2H_LANG}->{...} as title. To add a new languages, supply list of titles (see $T2H_WORDS), and use ISO 639 language codes (see e.g. perl module Locale-Codes-1.02.tar.gz for definitions).

If you don't give a -lang then we got it from the Texinfo source file (@documentlanguage see documentlanguage (Texinfo)). If there is no @documentlanguage we use the default en for the language.

LaTeX2HTML for @math and @tex
=============================

-l2h if set, uses latex2html for generation of math content.

Where to find latex2html
------------------------

-l2h_l2h name/location of latex2html program.

Skip calling LaTeX2HTML
-----------------------

-l2h_skip if set, skips actual call to latex2html: tries to reuse previously generated content, instead.

Temporary files for LaTeX2HTML
------------------------------

-l2h_tmp if set, l2h uses this directory for temporary files.  The path leading to this directory may not contain a dot (i.e., a .); otherwise, l2h will fail.