Debian Codegraph @

upstream/debian-trixie/man1/texi2dvi.1

raw
1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.1.
2 .TH TEXI2DVI "1" "September 2024" "texi2dvi (GNU Texinfo 7.1.1)" "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\-\-html\fR
58 output an HTML file from LaTeX, using HeVeA
59 .TP
60 \fB\-\-info\fR
61 output an Info file from LaTeX, using HeVeA
62 .TP
63 \fB\-p\fR, \fB\-\-pdf\fR
64 use pdftex or pdflatex for processing
65 .TP
66 \fB\-\-ps\fR
67 output a PostScript file via DVI (using dvips)
68 .TP
69 \fB\-\-text\fR
70 output a plain text file from LaTeX, using HeVeA
71 .SS "TeX tuning:"
72 .TP
73 \fB\-E\fR, \fB\-\-expand\fR
74 macro expansion using makeinfo
75 .TP
76 \fB\-I\fR DIR
77 search DIR for Texinfo files
78 .TP
79 \fB\-l\fR, \fB\-\-language\fR=\fI\,LANG\/\fR
80 specify LANG for FILE, either latex or texinfo
81 .TP
82 \fB\-\-no\-line\-error\fR
83 do not pass \fB\-\-file\-line\-error\fR to TeX
84 .TP
85 \fB\-\-shell\-escape\fR
86 pass \fB\-\-shell\-escape\fR to TeX
87 .TP
88 \fB\-\-src\-specials\fR
89 pass \fB\-\-src\-specials\fR to TeX
90 .TP
91 \fB\-\-translate\-file\fR=\fI\,FILE\/\fR
92 use given charset translation file for TeX
93 .TP
94 \fB\-t\fR, \fB\-\-command\fR=\fI\,CMD\/\fR
95 insert CMD in copy of input file
96 .SS "Build modes:"
97 .TP
98 \fB\-\-build\fR=\fI\,MODE\/\fR
99 specify the treatment of auxiliary files [local]
100 .TP
101 \fB\-\-tidy\fR
102 same as \fB\-\-build\fR=\fI\,tidy\/\fR
103 .TP
104 \fB\-c\fR, \fB\-\-clean\fR
105 same as \fB\-\-build\fR=\fI\,clean\/\fR
106 .TP
107 \fB\-\-build\-dir\fR=\fI\,DIR\/\fR
108 specify where the tidy compilation is performed;
109 implies \fB\-\-tidy\fR
110 .PP
111 The MODE specifies where the TeX compilation takes place, and, as a
112 consequence, how auxiliary files are treated.
113 .SS "Valid values of MODE are:"
114 .TP
115 `local'
116 compile in the current directory, leaving all the auxiliary
117 files around. This is the traditional TeX use.
118 .TP
119 `tidy'
120 compile in a local *.t2d directory, where the auxiliary files
121 are left. Output files are copied back to the original file.
122 .TP
123 `clean'
124 same as `tidy', but remove the auxiliary directory afterwards.
125 Every compilation therefore requires the full cycle.
126 .PP
127 The build mode can also be set using the environment variable
128 TEXI2DVI_BUILD_MODE. The tidy build directory can also be set using
129 the environment variable TEXI2DVI_BUILD_DIRECTORY.
130 .PP
131 The values of these environment variables are used to run the
132 corresponding commands, if they are set:
133 .IP
134 BIBER BIBTEX DVIPDF DVIPS EGREP HEVEA LATEX MAKEINDEX MAKEINFO
135 PDFLATEX PDFTEX SED T4HT TEX TEX4HT TEXINDEX TEXINDY THUMBPDF_CMD
136 .PP
137 Regarding \fB\-\-dvipdf\fR, if DVIPDF is not set in the environment, the
138 following programs are looked for (in this order): dvipdfmx dvipdfm
139 dvipdf dvi2pdf dvitopdf.
140 .PP
141 If Texinfo is installed on your site, then the command
142 .IP
143 info texi2dvi
144 .PP
145 should give you access to more documentation.
146 .SH "REPORTING BUGS"
147 Report bugs to bug\[email protected],
148 general questions and discussion to help\[email protected].
149 .br
150 GNU Texinfo home page: <http://www.gnu.org/software/texinfo/>
151 .br
152 General help using GNU software: <http://www.gnu.org/gethelp/>
153 .SH COPYRIGHT
154 Copyright \(co 2024 Free Software Foundation, Inc.
155 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
156 .br
157 This is free software: you are free to change and redistribute it.
158 There is NO WARRANTY, to the extent permitted by law.
159 .SH "SEE ALSO"
160 The full documentation for
161 .B texi2dvi
162 is maintained as a Texinfo manual. If the
163 .B info
164 and
165 .B texi2dvi
166 programs are properly installed at your site, the command
167 .IP
168 .B info texi2dvi
169 .PP
170 should give you access to the complete manual.