19.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 output formats are requested, after checking the validity of the input to give users the benefit of texi2any’s error checking. If you don’t want such error checking, perhaps because your manual plays advanced TeX tricks together with texinfo.tex, just invoke texi2dvi directly.

The output format options for this are --dvi, --dvipdf, --pdf, and --ps. See 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

except for the validity check.

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 Other Customization Variables). As you might guess, the default is ‘texi2dvi’.

texi2any itself does not generate any normal output when it invokes texi2dvi, only diagnostic messages.