22.3 texi2any Printed Output

To justify the name Texinfo-to-any, texi2any has basic support for creating printed output in the various formats: TeX DVI, PDF, and PostScript. This is done via the simple method of executing the texi2dvi program when those outputs are requested.

The output format options for this are ‘--dvi’, ‘--dvipdf’, ‘--pdf’, and ‘--ps’. See section Format with texi2dvi, for more details on these options and general texi2dvi operation. In addition, the ‘--verbose’, ‘--silent’, and ‘--quiet’ options are passed on if specified; the ‘-I’ and ‘-o’ options are likewise passed on with their arguments, and ‘--debug’ without its argument.

The only option remaining that is related to the texi2dvi invocation is ‘--Xopt’. Here, just the argument is passed on and multiple ‘--Xopt’ options accumulate. This provides a way to construct an arbitrary command line for texi2dvi. For example, running

texi2any --Xopt -t --Xopt @a4paper --pdf foo.texi

is equivalent to running

texi2dvi -t @a4paper --pdf foo.texi

Although one might wish that other options to texi2any would take effect, they don’t. For example, running ‘texi2any --no-number-sections --dvi foo.texi’ still results in a DVI file with numbered sections. (Perhaps this could be improved in the future, if requests are received.)

The actual name of the command that is invoked is specified by the TEXI2DVI customization variable (see section Other Customization Variables). As you might guess, the default is ‘texi2dvi’.

texi2any itself does not generate any output when it invokes texi2dvi.

This document was generated on October 2, 2013 using texi2html 5.0.