man pages section 1: User Commands

Exit Print View

Updated: July 2014

texi2dvi (1)


texi2dvi - convert Texinfo documents to DVI


texi2dvi [OPTION]... FILE...


User Commands                                         TEXI2DVI(1)

     texi2dvi - convert Texinfo documents to DVI

     texi2dvi [OPTION]... FILE...

     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 when needed.

  General options:
     -b, --batch
          no interaction

     -D, --debug
          turn on shell debugging (set -x)

     -h, --help
          display this help and exit successfully

     -o, --output=OFILE
          leave output in OFILE (implies --clean); only one input
          FILE may be specified in this case

     -q, --quiet
          no output unless errors (implies --batch)

     -s, --silent
          same as --quiet

     -v, --version
          display version information and exit successfully

     -V, --verbose
          report on what is done

texi2dvi 1.135     Last change: September 2008                  1

User Commands                                         TEXI2DVI(1)

  TeX tuning:
     -@   use @input instead of \input for preloaded Texinfo

          output a DVI file [default]

          output a PDF file via DVI (using dvipdf)

     -e, -E, --expand
          force macro expansion using makeinfo

     -I DIR
          search DIR for Texinfo files

     -l, --language=LANG
          specify LANG for FILE, either latex or texinfo

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

     -p, --pdf
          use pdftex or pdflatex for processing

     -r, --recode
          call recode before TeX to translate input

          recode from ENC to the @documentencoding

          pass --src-specials to TeX

     -t, --command=CMD
          insert CMD in copy of input file

     or --texinfo=CMD
          multiple values accumulate

          use given charset translation file for TeX

  Build modes:
          specify the treatment of auxiliary files [local]

          same as --build=tidy

     -c, --clean
          same as --build=clean

texi2dvi 1.135     Last change: September 2008                  2

User Commands                                         TEXI2DVI(1)

          specify  where  the  tidy  compilation  is   performed;
          implies  --tidy;  defaults  to TEXI2DVI_BUILD_DIRECTORY

          remove the auxiliary files and directories but not  the

     The  MODE  specifies  where the TeX compilation takes place,
     and, as a consequence, how auxiliary files are treated.  The
     build  mode  can  also be set using the environment variable

  Valid MODEs are:
          compile in the current directory, leaving all the  aux-
          iliary  files around.  This is the traditional TeX use.

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

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

  Using the `tidy' mode brings several advantages:
     -    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 or --build-dir=$HOME/.t2d.

     -    the  output  file  is updated after every succesful TeX
          run, for sake of concurrent visualization of  the  out-
          put.   In  a  `local' build the viewer stops during the
          whole TeX run.

     -    if the compilation fails, the  previous  state  of  the
          output file is preserved.

     -    PDF  and DVI compilation are kept in separate subdirec-
          tories preventing any  possibility  of  auxiliary  file

texi2dvi 1.135     Last change: September 2008                  3

User Commands                                         TEXI2DVI(1)

     On the other hand, because `tidy' compilation takes place in
     another directory, occasionally TeX won't 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,
     ment variables are used to run those commands, if  they  are
     set.   Any CMD strings are added after @setfilename for Tex-
     info input, in the first line for LaTeX input.

     Email bug reports to  <>,  general  ques-
     tions  and  discussion  to  <>.  Texinfo
     home page:

     Copyright (C) 2008 Free Software Foundation,  Inc.   License
     GPLv3+:      GNU      GPL     version     3     or     later
     This is free software: you are free  to  change  and  redis-
     tribute  it.   There is NO WARRANTY, to the extent permitted
     by law.

     See  attributes(5)  for  descriptions   of   the   following

     |Availability   | text/texinfo     |
     |Stability      | Volatile         |
     The  full documentation for texi2dvi is maintained as a Tex-
     info manual.  If the info and texi2dvi programs are properly
     installed at your site, the command

          info texi2dvi

     should give you access to the complete manual.

     This   software   was   built   from   source  available  at   The   original
     community       source       was       downloaded       from

texi2dvi 1.135     Last change: September 2008                  4

User Commands                                         TEXI2DVI(1)

     Further information about this software can be found on  the
     open  source  community  website at

texi2dvi 1.135     Last change: September 2008                  5