General options:¶

-D, --debug

turn on shell debugging (set -x)

-h, --help

display this help and exit successfully

-o, --output=OFILE

leave output in OFILE; only one input FILE is allowed

-q, --quiet

no output unless errors

-v, --version

display version information and exit successfully

-V, --verbose

report on what is done

--max-iterations=N

don't process files more than N times [7]

--mostly-clean

remove auxiliary files or directories from previous runs (but not the output)

Output format:¶

--dvi

output a DVI file [default]

--dvipdf

output a PDF file via DVI (using a dvi-to-pdf program)

--html

output an HTML file from LaTeX, using HeVeA

--info

output an Info file from LaTeX, using HeVeA

-p, --pdf

use pdftex or pdflatex for processing

--ps

output a PostScript file via DVI (using dvips)

--text

output a plain text file from LaTeX, using HeVeA

TeX tuning:¶

-E, --expand

macro expansion using makeinfo

-I DIR

search DIR for Texinfo files

-l, --language=LANG

specify LANG for FILE, either latex or texinfo

--no-line-error

do not pass --file-line-error to TeX

--shell-escape

pass --shell-escape to TeX

--src-specials

pass --src-specials to TeX

--translate-file=FILE

use given charset translation file for TeX

-t, --command=CMD

insert CMD in copy of input file

Build modes:¶

--build=MODE

specify the treatment of auxiliary files [local]

--tidy

same as --build=tidy

-c, --clean

same as --build=clean

--build-dir=DIR

specify where the tidy compilation is performed; implies --tidy

The MODE specifies where the TeX compilation takes place, and, as a consequence, how auxiliary files are treated.

Valid values of MODE are:¶

`local'

compile in the current directory, leaving all the auxiliary files around. This is the traditional TeX use.

`tidy'

compile in a local *.t2d directory, where the auxiliary files are left. Output files are copied back to the original file.

`clean'

same as `tidy', but remove the auxiliary directory afterwards. Every compilation therefore requires the full cycle.

The build mode can also be set using the environment variable TEXI2DVI_BUILD_MODE. The tidy build directory can also be set using the environment variable TEXI2DVI_BUILD_DIRECTORY.

The values of these environment variables are used to run the corresponding commands, if they are set:

BIBER BIBTEX DVIPDF DVIPS EGREP HEVEA LATEX MAKEINDEX MAKEINFO PDFLATEX PDFTEX SED T4HT TEX TEX4HT TEXINDEX TEXINDY THUMBPDF_CMD

Regarding --dvipdf, if DVIPDF is not set in the environment, the following programs are looked for (in this order): dvipdfmx dvipdfm dvipdf dvi2pdf dvitopdf.

If Texinfo is installed on your site, then the command

info texi2dvi

should give you access to more documentation.