Run each Texinfo or (La)TeX FILE through TeX in turn until all
cross-references are resolved, building all indices. The directory
containing each FILE is searched for included files. The suffix of FILE
is used to determine its language ((La)TeX or Texinfo). To process
(e)plain TeX files, set the environment variable LATEX=tex.
In order to make texi2dvi a drop-in replacement of TeX/LaTeX in AUC-TeX,
the FILE may also be composed of the following simple TeX commands.
the actual file to compile
same as --batch
Makeinfo is used to perform Texinfo macro expansion before running TeX
the current directory is not cluttered with plethora of temporary files.
clutter can be even reduced using --build-dir=dir: all the *.t2d
directories are stored there.
clutter can be reduced to zero using, e.g., --build-dir=/tmp/$USER.t2d
the output file is updated after every succesful TeX run, for
sake of concurrent visualization of the output. In a local build
the viewer stops during the whole TeX run.
if the compilation fails, the previous state of the output file
PDF and DVI compilation are kept in separate subdirectories
preventing any possibility of auxiliary file incompatibility.
On the other hand, because tidy compilation takes place in another
directory, occasionally TeX wont be able to find some files (e.g., when
using \graphicspath): in that case use -I to specify the additional
directories to consider.
The values of the BIBTEX, LATEX (or PDFLATEX), MAKEINDEX, MAKEINFO,
TEX (or PDFTEX), TEXINDEX, and THUMBPDF environment variables are used
to run those commands, if they are set. Any CMD strings are added
after @setfilename for Texinfo input, in the first line for LaTeX input.