summaryrefslogtreecommitdiffstats
path: root/upstream/fedora-40/man1/texi2dvi.1
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/fedora-40/man1/texi2dvi.1')
-rw-r--r--upstream/fedora-40/man1/texi2dvi.1170
1 files changed, 170 insertions, 0 deletions
diff --git a/upstream/fedora-40/man1/texi2dvi.1 b/upstream/fedora-40/man1/texi2dvi.1
new file mode 100644
index 00000000..cb5ee6f7
--- /dev/null
+++ b/upstream/fedora-40/man1/texi2dvi.1
@@ -0,0 +1,170 @@
+.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.1.
+.TH TEXI2DVI "1" "October 2023" "texi2dvi (GNU Texinfo 7.1)" "User Commands"
+.SH NAME
+texi2dvi \- convert Texinfo documents to DVI or PDF
+.SH SYNOPSIS
+.B texi2dvi
+[\fI\,OPTION\/\fR]... \fI\,FILE\/\fR...
+.br
+.B texi2pdf
+[\fI\,OPTION\/\fR]... \fI\,FILE\/\fR...
+.br
+.B pdftexi2dvi
+[\fI\,OPTION\/\fR]... \fI\,FILE\/\fR...
+.SH DESCRIPTION
+Run each Texinfo or (La)TeX FILE through TeX in turn until all
+cross\-references are resolved, building all indices. The directory
+containing each FILE is searched for included files. The suffix of FILE
+is used to determine its language ((La)TeX or Texinfo). To process
+(e)plain TeX files, set the environment variable LATEX=tex.
+.PP
+When invoked as `texi2pdf' or given the option \fB\-\-pdf\fR generate PDF output.
+Otherwise, generate DVI.
+.SS "General options:"
+.TP
+\fB\-D\fR, \fB\-\-debug\fR
+turn on shell debugging (set \fB\-x\fR)
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+display this help and exit successfully
+.TP
+\fB\-o\fR, \fB\-\-output\fR=\fI\,OFILE\/\fR
+leave output in OFILE; only one input FILE is allowed
+.TP
+\fB\-q\fR, \fB\-\-quiet\fR
+no output unless errors
+.TP
+\fB\-v\fR, \fB\-\-version\fR
+display version information and exit successfully
+.TP
+\fB\-V\fR, \fB\-\-verbose\fR
+report on what is done
+.TP
+\fB\-\-max\-iterations\fR=\fI\,N\/\fR
+don't process files more than N times [7]
+.TP
+\fB\-\-mostly\-clean\fR
+remove auxiliary files or directories from
+previous runs (but not the output)
+.SS "Output format:"
+.TP
+\fB\-\-dvi\fR
+output a DVI file [default]
+.TP
+\fB\-\-dvipdf\fR
+output a PDF file via DVI (using a dvi\-to\-pdf program)
+.TP
+\fB\-\-html\fR
+output an HTML file from LaTeX, using HeVeA
+.TP
+\fB\-\-info\fR
+output an Info file from LaTeX, using HeVeA
+.TP
+\fB\-p\fR, \fB\-\-pdf\fR
+use pdftex or pdflatex for processing
+.TP
+\fB\-\-ps\fR
+output a PostScript file via DVI (using dvips)
+.TP
+\fB\-\-text\fR
+output a plain text file from LaTeX, using HeVeA
+.SS "TeX tuning:"
+.TP
+\fB\-E\fR, \fB\-\-expand\fR
+macro expansion using makeinfo
+.TP
+\fB\-I\fR DIR
+search DIR for Texinfo files
+.TP
+\fB\-l\fR, \fB\-\-language\fR=\fI\,LANG\/\fR
+specify LANG for FILE, either latex or texinfo
+.TP
+\fB\-\-no\-line\-error\fR
+do not pass \fB\-\-file\-line\-error\fR to TeX
+.TP
+\fB\-\-shell\-escape\fR
+pass \fB\-\-shell\-escape\fR to TeX
+.TP
+\fB\-\-src\-specials\fR
+pass \fB\-\-src\-specials\fR to TeX
+.TP
+\fB\-\-translate\-file\fR=\fI\,FILE\/\fR
+use given charset translation file for TeX
+.TP
+\fB\-t\fR, \fB\-\-command\fR=\fI\,CMD\/\fR
+insert CMD in copy of input file
+.SS "Build modes:"
+.TP
+\fB\-\-build\fR=\fI\,MODE\/\fR
+specify the treatment of auxiliary files [local]
+.TP
+\fB\-\-tidy\fR
+same as \fB\-\-build\fR=\fI\,tidy\/\fR
+.TP
+\fB\-c\fR, \fB\-\-clean\fR
+same as \fB\-\-build\fR=\fI\,clean\/\fR
+.TP
+\fB\-\-build\-dir\fR=\fI\,DIR\/\fR
+specify where the tidy compilation is performed;
+implies \fB\-\-tidy\fR
+.PP
+The MODE specifies where the TeX compilation takes place, and, as a
+consequence, how auxiliary files are treated.
+.SS "Valid values of MODE are:"
+.TP
+`local'
+compile in the current directory, leaving all the auxiliary
+files around. This is the traditional TeX use.
+.TP
+`tidy'
+compile in a local *.t2d directory, where the auxiliary files
+are left. Output files are copied back to the original file.
+.TP
+`clean'
+same as `tidy', but remove the auxiliary directory afterwards.
+Every compilation therefore requires the full cycle.
+.PP
+The build mode can also be set using the environment variable
+TEXI2DVI_BUILD_MODE. The tidy build directory can also be set using
+the environment variable TEXI2DVI_BUILD_DIRECTORY.
+.PP
+The values of these environment variables are used to run the
+corresponding commands, if they are set:
+.IP
+BIBER BIBTEX DVIPDF DVIPS EGREP HEVEA LATEX MAKEINDEX MAKEINFO
+PDFLATEX PDFTEX SED T4HT TEX TEX4HT TEXINDEX TEXINDY THUMBPDF_CMD
+.PP
+Regarding \fB\-\-dvipdf\fR, if DVIPDF is not set in the environment, the
+following programs are looked for (in this order): dvipdfmx dvipdfm
+dvipdf dvi2pdf dvitopdf.
+.PP
+If Texinfo is installed on your site, then the command
+.IP
+info texi2dvi
+.PP
+should give you access to more documentation.
+.SH "REPORTING BUGS"
+Report bugs to bug\-texinfo@gnu.org,
+general questions and discussion to help\-texinfo@gnu.org.
+.br
+GNU Texinfo home page: <http://www.gnu.org/software/texinfo/>
+.br
+General help using GNU software: <http://www.gnu.org/gethelp/>
+.SH COPYRIGHT
+Copyright \(co 2023 Free Software Foundation, Inc.
+License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
+.br
+This is free software: you are free to change and redistribute it.
+There is NO WARRANTY, to the extent permitted by law.
+.SH "SEE ALSO"
+The full documentation for
+.B texi2dvi
+is maintained as a Texinfo manual. If the
+.B info
+and
+.B texi2dvi
+programs are properly installed at your site, the command
+.IP
+.B info texi2dvi
+.PP
+should give you access to the complete manual.