Debian Codegraph @

upstream/debian-unstable/man1/texi2dvi.1

raw
1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3.
2 .TH TEXI2DVI "1" "March 2026" "texi2dvi (GNU Texinfo 7.3)" "User Commands"
3 .SH NAME
4 texi2dvi \- convert Texinfo documents to DVI or PDF
5 .SH SYNOPSIS
6 .B texi2dvi
7 [\fI\,OPTION\/\fR]... \fI\,FILE\/\fR...
8 .br
9 .B texi2pdf
10 [\fI\,OPTION\/\fR]... \fI\,FILE\/\fR...
11 .br
12 .B pdftexi2dvi
13 [\fI\,OPTION\/\fR]... \fI\,FILE\/\fR...
14 .SH DESCRIPTION
15 Run each Texinfo or (La)TeX FILE through TeX in turn until all
16 cross\-references are resolved, building all indices. The directory
17 containing each FILE is searched for included files. The suffix of FILE
18 is used to determine its language ((La)TeX or Texinfo). To process
19 (e)plain TeX files, set the environment variable LATEX=tex.
20 .PP
21 When invoked as `texi2pdf' or given the option \fB\-\-pdf\fR generate PDF output.
22 Otherwise, generate DVI.
23 .SS "General options:"
24 .TP
25 \fB\-D\fR, \fB\-\-debug\fR
26 turn on shell debugging (set \fB\-x\fR)
27 .TP
28 \fB\-h\fR, \fB\-\-help\fR
29 display this help and exit successfully
30 .TP
31 \fB\-o\fR, \fB\-\-output\fR=\fI\,OFILE\/\fR
32 leave output in OFILE; only one input FILE is allowed
33 .TP
34 \fB\-q\fR, \fB\-\-quiet\fR
35 no output unless errors
36 .TP
37 \fB\-v\fR, \fB\-\-version\fR
38 display version information and exit successfully
39 .TP
40 \fB\-V\fR, \fB\-\-verbose\fR
41 report on what is done
42 .TP
43 \fB\-\-max\-iterations\fR=\fI\,N\/\fR
44 don't process files more than N times [7]
45 .TP
46 \fB\-\-mostly\-clean\fR
47 remove auxiliary files or directories from
48 previous runs (but not the output)
49 .SS "Output format:"
50 .TP
51 \fB\-\-dvi\fR
52 output a DVI file [default]
53 .TP
54 \fB\-\-dvipdf\fR
55 output a PDF file via DVI (using a dvi\-to\-pdf program)
56 .TP
57 \fB\-p\fR, \fB\-\-pdf\fR
58 use pdftex or pdflatex for processing
59 .TP
60 \fB\-\-ps\fR
61 output a PostScript file via DVI (using dvips)
62 .SS "TeX tuning:"
63 .TP
64 \fB\-E\fR, \fB\-\-expand\fR
65 macro expansion using makeinfo
66 .TP
67 \fB\-I\fR DIR
68 search DIR for Texinfo files
69 .TP
70 \fB\-l\fR, \fB\-\-language\fR=\fI\,LANG\/\fR
71 specify LANG for FILE, either latex or texinfo
72 .TP
73 \fB\-\-no\-line\-error\fR
74 do not pass \fB\-\-file\-line\-error\fR to TeX
75 .TP
76 \fB\-\-shell\-escape\fR
77 pass \fB\-\-shell\-escape\fR to TeX
78 .TP
79 \fB\-\-src\-specials\fR
80 pass \fB\-\-src\-specials\fR to TeX
81 .TP
82 \fB\-\-translate\-file\fR=\fI\,FILE\/\fR
83 use given charset translation file for TeX
84 .TP
85 \fB\-t\fR, \fB\-\-command\fR=\fI\,CMD\/\fR
86 insert CMD in copy of input file
87 .SS "Build modes:"
88 .TP
89 \fB\-\-build\fR=\fI\,MODE\/\fR
90 specify the treatment of auxiliary files [local]
91 .TP
92 \fB\-\-tidy\fR
93 same as \fB\-\-build\fR=\fI\,tidy\/\fR
94 .TP
95 \fB\-c\fR, \fB\-\-clean\fR
96 same as \fB\-\-build\fR=\fI\,clean\/\fR
97 .TP
98 \fB\-\-build\-dir\fR=\fI\,DIR\/\fR
99 specify where the tidy compilation is performed;
100 implies \fB\-\-tidy\fR
101 .PP
102 The MODE specifies where the TeX compilation takes place, and, as a
103 consequence, how auxiliary files are treated.
104 .SS "Valid values of MODE are:"
105 .TP
106 `local'
107 compile in the current directory, leaving all the auxiliary
108 files around. This is the traditional TeX use.
109 .TP
110 `tidy'
111 compile in a local *.t2d directory, where the auxiliary files
112 are left. Output files are copied back to the original file.
113 .TP
114 `clean'
115 same as `tidy', but remove the auxiliary directory afterwards.
116 Every compilation therefore requires the full cycle.
117 .PP
118 The build mode can also be set using the environment variable
119 TEXI2DVI_BUILD_MODE. The tidy build directory can also be set using
120 the environment variable TEXI2DVI_BUILD_DIRECTORY.
121 .PP
122 The values of these environment variables are used to run the
123 corresponding commands, if they are set:
124 .IP
125 BIBER BIBTEX DVIPDF DVIPS EGREP LATEX MAKEINDEX MAKEINFO
126 PDFLATEX PDFTEX SED TEX TEXINDEX TEXINDY THUMBPDF_CMD
127 .PP
128 Regarding \fB\-\-dvipdf\fR, if DVIPDF is not set in the environment, the
129 following programs are looked for (in this order): dvipdfmx dvipdfm
130 dvipdf dvi2pdf dvitopdf.
131 .PP
132 If Texinfo is installed on your site, then the command
133 .IP
134 info texi2dvi
135 .PP
136 should give you access to more documentation.
137 .SH "REPORTING BUGS"
138 Report bugs to bug\[email protected],
139 general questions and discussion to help\[email protected].
140 .br
141 GNU Texinfo home page: <https://www.gnu.org/software/texinfo/>
142 .br
143 General help using GNU software: <http://www.gnu.org/gethelp/>
144 .SH COPYRIGHT
145 Copyright \(co 2026 Free Software Foundation, Inc.
146 License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>
147 .br
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 .SH "SEE ALSO"
151 The full documentation for
152 .B texi2dvi
153 is maintained as a Texinfo manual. If the
154 .B info
155 and
156 .B texi2dvi
157 programs are properly installed at your site, the command
158 .IP
159 .B info texi2dvi
160 .PP
161 should give you access to the complete manual.