1TEXI2DVI(1)                      User Commands                     TEXI2DVI(1)
2
3
4

NAME

6       texi2dvi - convert Texinfo documents to DVI or PDF
7

SYNOPSIS

9       texi2dvi [OPTION]... FILE...
10       texi2pdf [OPTION]... FILE...
11       pdftexi2dvi [OPTION]... FILE...
12

DESCRIPTION

14       Run  each  Texinfo  or  (La)TeX  FILE  through  TeX  in  turn until all
15       cross-references are resolved, building  all  indices.   The  directory
16       containing  each  FILE  is  searched for included files.  The suffix of
17       FILE is used to  determine  its  language  ((La)TeX  or  Texinfo).   To
18       process (e)plain TeX files, set the environment variable LATEX=tex.
19
20       When  invoked as `texi2pdf' or given the option --pdf generate PDF out‐
21       put.  Otherwise, generate DVI.
22
23   General options:
24       -b, --batch
25              no interaction
26
27       -D, --debug
28              turn on shell debugging (set -x)
29
30       -h, --help
31              display this help and exit successfully
32
33       -o, --output=OFILE
34              leave output in OFILE; only one input FILE is allowed
35
36       -q, --quiet
37              no output unless errors (implies --batch)
38
39       -v, --version
40              display version information and exit successfully
41
42       -V, --verbose
43              report on what is done
44
45       --max-iterations=N
46              don't process files more than N times [7]
47
48       --mostly-clean
49              remove auxiliary files or directories from  previous  runs  (but
50              not the output)
51
52   Output format:
53       --dvi  output a DVI file [default]
54
55       --dvipdf
56              output a PDF file via DVI (using a dvi-to-pdf program)
57
58       --html output an HTML file from LaTeX, using HeVeA
59
60       --info output an Info file from LaTeX, using HeVeA
61
62       -p, --pdf
63              use pdftex or pdflatex for processing
64
65       --ps   output a PostScript file via DVI (using dvips)
66
67       --text output a plain text file from LaTeX, using HeVeA
68
69   TeX tuning:
70       -E, --expand
71              macro expansion using makeinfo
72
73       -I DIR search DIR for Texinfo files
74
75       -l, --language=LANG
76              specify LANG for FILE, either latex or texinfo
77
78       --no-line-error
79              do not pass --file-line-error to TeX
80
81       --shell-escape
82              pass --shell-escape to TeX
83
84       --src-specials
85              pass --src-specials to TeX
86
87       --translate-file=FILE
88              use given charset translation file for TeX
89
90       -t, --command=CMD
91              insert CMD in copy of input file
92
93   Build modes:
94       --build=MODE
95              specify the treatment of auxiliary files [local]
96
97       --tidy same as --build=tidy
98
99       -c, --clean
100              same as --build=clean
101
102       --build-dir=DIR
103              specify where the tidy compilation is performed; implies --tidy;
104              defaults to TEXI2DVI_BUILD_DIRECTORY [.]
105
106       The MODE specifies where the TeX compilation takes  place,  and,  as  a
107       consequence,  how auxiliary files are treated.  The build mode can also
108       be set using the environment variable TEXI2DVI_BUILD_MODE.
109
110   Valid values of MODE are:
111       `local'
112              compile in the current  directory,  leaving  all  the  auxiliary
113              files around.  This is the traditional TeX use.
114
115       `tidy' compile  in  a  local *.t2d directory, where the auxiliary files
116              are left.  Output files are copied back to the original file.
117
118       `clean'
119              same as `tidy', but remove the auxiliary  directory  afterwards.
120              Every compilation therefore requires the full cycle.
121
122       The  values  of  these environment variables are used to run the corre‐
123       sponding commands, if they are set:
124
125              BIBER BIBTEX DVIPDF DVIPS EGREP HEVEA LATEX  MAKEINDEX  MAKEINFO
126              PDFLATEX   PDFTEX   SED   T4HT   TEX   TEX4HT  TEXINDEX  TEXINDY
127              THUMBPDF_CMD
128
129       Regarding --dvipdf, if DVIPDF is not set in the environment,  the  fol‐
130       lowing programs are looked for (in this order): dvipdfmx dvipdfm dvipdf
131       dvi2pdf dvitopdf.
132
133       If Texinfo is installed on your site, then the command
134
135              info texi2dvi
136
137       should give you access to more documentation.
138

REPORTING BUGS

140       Report bugs to bug-texinfo@gnu.org, general questions and discussion to
141       help-texinfo@gnu.org.
142       GNU Texinfo home page: <http://www.gnu.org/software/texinfo/>
143       General help using GNU software: <http://www.gnu.org/gethelp/>
144

COPYRIGHT

146       Copyright  ©  2019  Free Software Foundation, Inc.  License GPLv3+: GNU
147       GPL version 3 or later <http://gnu.org/licenses/gpl.html>
148       This is free software: you are free  to  change  and  redistribute  it.
149       There is NO WARRANTY, to the extent permitted by law.
150

SEE ALSO

152       The  full documentation for texi2dvi is maintained as a Texinfo manual.
153       If the info and texi2dvi programs are properly installed at your  site,
154       the command
155
156              info texi2dvi
157
158       should give you access to the complete manual.
159
160
161
162texi2dvi (GNU Texinfo 6.6)       February 2019                     TEXI2DVI(1)