texinfo: texi2any Printed Output

Generic Translator texi2any

Pointer Validation

Invoking texi2any

Back to Software Index

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'.  Note: 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 (Note: Other Customization
Variables).  As you might guess, the default is 'texi2dvi'.

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