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       Any  CMD  strings are added after @setfilename for Texinfo input, or in
94       the first line for LaTeX input.  Multiple values accumulate.
95
96   Build modes:
97       --build=MODE
98              specify the treatment of auxiliary files [local]
99
100       --tidy same as --build=tidy
101
102       -c, --clean
103              same as --build=clean
104
105       --build-dir=DIR
106              specify where the tidy compilation is performed; implies --tidy;
107              defaults to TEXI2DVI_BUILD_DIRECTORY [.]
108
109       The  MODE  specifies  where  the TeX compilation takes place, and, as a
110       consequence, how auxiliary files are treated.  The build mode can  also
111       be set using the environment variable TEXI2DVI_BUILD_MODE.
112
113   Valid values of MODE are:
114       `local'
115              compile  in  the  current  directory,  leaving all the auxiliary
116              files around.  This is the traditional TeX use.
117
118       `tidy' compile in a local *.t2d directory, where  the  auxiliary  files
119              are left.  Output files are copied back to the original file.
120
121       `clean'
122              same  as  `tidy', but remove the auxiliary directory afterwards.
123              Every compilation therefore requires the full cycle.
124
125       The values of these environment variables are used to  run  the  corre‐
126       sponding commands, if they are set:
127
128              BIBER  BIBTEX  DVIPDF DVIPS EGREP HEVEA LATEX MAKEINDEX MAKEINFO
129              PDFLATEX  PDFTEX  SED   T4HT   TEX   TEX4HT   TEXINDEX   TEXINDY
130              THUMBPDF_CMD
131
132       Regarding  --dvipdf,  if DVIPDF is not set in the environment, the fol‐
133       lowing programs are looked for (in this order): dvipdfmx dvipdfm dvipdf
134       dvi2pdf dvitopdf.
135
136       If Texinfo is installed on your site, then the command
137
138              info texi2dvi
139
140       should give you access to more documentation.
141

REPORTING BUGS

143       Report bugs to bug-texinfo@gnu.org, general questions and discussion to
144       help-texinfo@gnu.org.
145       GNU Texinfo home page: <http://www.gnu.org/software/texinfo/>
146       General help using GNU software: <http://www.gnu.org/gethelp/>
147
149       Copyright © 2017 Free Software Foundation, Inc.   License  GPLv3+:  GNU
150       GPL version 3 or later <http://gnu.org/licenses/gpl.html>
151       This  is  free  software:  you  are free to change and redistribute it.
152       There is NO WARRANTY, to the extent permitted by law.
153

SEE ALSO

155       The full documentation for texi2dvi is maintained as a Texinfo  manual.
156       If  the info and texi2dvi programs are properly installed at your site,
157       the command
158
159              info texi2dvi
160
161       should give you access to the complete manual.
162
163
164
165texi2dvi 7906                   September 2017                     TEXI2DVI(1)
Impressum