diff options
Diffstat (limited to 'upstream/archlinux/man1/texi2dvi.1')
| -rw-r--r-- | upstream/archlinux/man1/texi2dvi.1 | 170 |
1 files changed, 170 insertions, 0 deletions
diff --git a/upstream/archlinux/man1/texi2dvi.1 b/upstream/archlinux/man1/texi2dvi.1 new file mode 100644 index 00000000..cb5ee6f7 --- /dev/null +++ b/upstream/archlinux/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. |