19.4.2 Customization Variables and Options

The following table gives the customization variables associated with some command line options. See Invoking texi2any from a Shell, for the meaning of the options.

OptionVariable
--enable-encodingENABLE_ENCODING
--document-languagedocumentlanguage
--error-limitERROR_LIMIT
--fill-columnFILLCOLUMN
--footnote-stylefootnotestyle
--forceFORCE
--internal-linksINTERNAL_LINKS
--macro-expandMACRO_EXPAND
--headersHEADERS, FORMAT_MENU
--no-warnNO_WARN
--no-validatenovalidate
--number-footnotesNUMBER_FOOTNOTES
--number-sectionsNUMBER_SECTIONS
--node-filesNODE_FILES
--outputOUTFILE, SUBDIR
--paragraph-indentparagraphindent
--silentSILENT
--splitSPLIT
--split-sizeSPLIT_SIZE
--transliterate-file-namesTRANSLITERATE_FILE_NAMES
--verboseVERBOSE

Setting such a customization variable to a value ‘foo’ is essentially the same as specifying the --opt=foo if the option takes an argument, or --opt if not.

In addition, the customization variable TEXINFO_OUTPUT_FORMAT allows specifying what texi2any outputs, either one of the usual output formats that can be specified with options, or various other forms:

docbook
dvi
dvipdf
epub3
html
info
pdf
plaintext
ps
xml

These correspond to the command-line options (and TEXINFO_OUTPUT_FORMAT environment variable values) of the same name. See Invoking texi2any from a Shell.

debugtree

Instead of generating a regular output format, output a text representation of the tree obtained by parsing the input texinfo document.

parse

Do only Texinfo source parsing; there is no output.

plaintexinfo

Output the Texinfo source with all the macros, @include and @value{} expanded. This is similar to setting --macro-expand, but instead of being output in addition to the normal conversion, output of Texinfo is the main output.

rawtext

Output raw text, with minimal formatting. For example, footnotes are ignored and there is no paragraph filling. This is used by the parser for file names and copyright text in HTML comments, for example.

structure

Do only Texinfo source parsing and determination of the document structure; there is no output.

texinfosxml

Output the document in TexinfoSXML representation, a syntax for writing XML data using Lisp S-expressions.

textcontent

Output the text content only, stripped of commands; this is useful for spell checking or word counting, for example. The trivial detexinfo script setting this is in the util directory of the Texinfo source as an example. It’s one line:

exec texi2any -c TEXINPUT_OUTPUT_FORMAT=textcontent "$@"