Next: , Up: Usage

3.1 Command line options

The most important option to texi2latex was already explained – it's the name of the Texinfo file, of course.

But you can add further options. They are given in an `name=value' form.1 So far, three options are defined:

Default: book

The document class of the resulting LaTeX file. Please bear in mind that Texinfo documents have chapters. Because of this and other things you should know what you're doing when you use this option.

Default: empty

Global options (enclosed by `[...]') given to the document class in the resulting LaTeX file. For example,

          texi2latex mymanual global-options=12pt

adds `12pt' to the \documentclass macro and thus switches the document font size to 12pt.

Default: no

If set to `yes', all tabulator characters in @verbatim environments are simply ignored. This behaviour could be interesting if you have very many @verbatim in your document, but no tabs used. The XSLT algorithm that handles tabs is rather costly, so this speeds the conversion up a bit. However, don't expect miracles: The original Texinfo manual with 27 @verbatims is processed faster by only 2%.

Default: no

If set to `yes', syntax highlighting for code displays is activated. Since Texinfo only supports @list so far, this option affects only Lisp code. Another constraint is that syntax highlighting is applied to displays only if they don't contain other formatting commands, e.g. @r{...} or something like that.

Technical note: These options are so-called “XSLT parameters”.


[1] With Windows' command line interpreter, you have to enclose every name-value pair with double quotes.