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

REPORTING BUGS

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

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

SEE ALSO

149       The  full documentation for texi2dvi is maintained as a Texinfo manual.
150       If the info and texi2dvi programs are properly installed at your  site,
151       the command
152
153              info texi2dvi
154
155       should give you access to the complete manual.
156
157
158
159texi2dvi (GNU Texinfo 6.8)         July 2021                       TEXI2DVI(1)
Impressum