TEXI2ANY(1)

📦
version 7.3 · 6 versions
, in alpine 3.24, arch rolling, nixpkgs unstable, ubuntu stonking

💅 TEXI2ANY(1) — the girlies' guide

okay bestie, this is texi2any, a User Command, and it translates Texinfo documents. That's the whole gig. She eats. ✨

🎀 NAME

texi2any — translate Texinfo documents 🦋

🌸 SYNOPSIS

makeinfo [OPTION]... TEXINFO-FILE...

✨ DESCRIPTION

She takes your Texinfo source documentation and turns it into a whole bunch of other formats. And by default? She makes Info files — you know, the kind you read online with Emacs or with standalone GNU Info. main character behavior fr fr.

Also important: this program is commonly installed as both makeinfo and texi2any. The behavior is identical, and it does not depend on which name got installed. So don't come for her about her name, she answers to both 💅

🧚 General options:

  • --document-language=STR — the locale used when translating Texinfo keywords for the output document (default is C)
  • --error-limit=NUM — she quits after NUM errors (default is 100), so like, know your limits bestie
  • --force — preserve the output even if there are errors. stubborn queen 👑
  • --help — display this help and exit
  • --no-validate — suppress node cross-reference validation
  • --no-warn — suppress warnings (but not errors, those still come through)
  • --conf-dir=DIR — search also for initialization files in DIR
  • --init-file=FILE — load FILE to modify the default behavior
  • -c, --set-customization-variable VAR=VAL — set the customization variable VAR to the value VAL
  • --trace-includes — print the names of included files
  • -v, --verbose — explain what is being done (she'll narrate, as she should)
  • --version — display version information and exit

🌈 Output format selection (default is to produce Info):

  • --docbook — output Docbook XML
  • --html — output HTML
  • --epub3 — output EPUB 3
  • --latex — output LaTeX
  • --plaintext — output plain text rather than Info
  • --xml — output Texinfo XML
  • --dvi, --dvipdf, --ps, --pdf — call texi2dvi to generate the given output, but only after checking the validity of TEXINFO-FILE

💖 General output options:

  • -E, --macro-expand=FILE — output the macro-expanded source to FILE, ignoring any @setfilename
  • --no-headers — suppress node separators, Node: lines, and menus from Info output (so you get plain text instead) or from HTML (so you get shorter output). Also, if you're producing Info, this makes her write to standard output by default.
  • --no-split — suppress any splitting of the output; generate only one output file
  • --[no-]number-sections — output chapter and sectioning numbers; default is on
  • --[no-]number-footnotes — number footnotes sequentially; default is on
  • -o, --output=DEST — output to DEST. With split output, create DEST as a directory and put the output files there. With non-split output, if DEST is already a directory or ends with a /, put the output file there. Otherwise, DEST names the output file.
  • --disable-encoding — do not output accented and special characters in Info and plain text output based on document encoding
  • --enable-encoding — override --disable-encoding (this is the default)

🍓 Options for Info and plain text:

  • --fill-column=NUM — break Info lines at NUM columns (default is 72)
  • --footnote-style=STYLE — output footnotes in Info according to STYLE: separate to put them in their own node; end to put them at the end of the node in which they are defined (this one is the default)
  • --paragraph-indent=VAL — indent Info paragraphs by VAL spaces (default is 3). If VAL is none, do not indent; if VAL is asis, preserve the existing indentation.
  • --split-size=NUM — split Info files at size NUM (default is 300000)

🦋 Options for HTML:

  • --css-include=FILE — include FILE in the HTML <style> output; read stdin if FILE is -
  • --css-ref=URL — generate a CSS reference to URL
  • --internal-links=FILE — produce a list of internal links in FILE
  • --split=SPLIT — split at SPLIT, where SPLIT may be chapter, section or node
  • --transliterate-file-names — use file names in ASCII transliteration
  • --node-files — produce redirection files for nodes and anchors; the default is set only if split

🔥 Options for DVI/PS/PDF:

  • --Xopt=OPT — pass OPT to texi2dvi; can be repeated

💜 Input file options:

  • -D VAR — define the variable VAR, as with @set
  • -D 'VAR VAL' — define VAR to VAL (as one shell argument)
  • -I DIR — append DIR to the @include search path
  • -P DIR — prepend DIR to the @include search path
  • -U VAR — undefine the variable VAR, as with @clear

⭐ Conditional processing in input:

  • --ifdocbook — process @ifdocbook and @docbook
  • --ifhtml — process @ifhtml and @html
  • --ifinfo — process @ifinfo
  • --iflatex — process @iflatex and @latex
  • --ifplaintext — process @ifplaintext
  • --iftex — process @iftex and @tex
  • --ifxml — process @ifxml and @xml

By default, an --ifFORMAT setting is on only when the output format is FORMAT. Like, --ifhtml is on when you're outputting HTML. Also, when --ifFORMAT is on, @ifnotFORMAT text is not processed.

Each --ifFORMAT option may be prefixed with --no- to negate it. For example, --no-ifhtml means not to process @ifhtml or @html text, and to process @ifnothtml text. got it? got it. 💖

🫶 EXAMPLES

  • makeinfo foo.texi — write Info
  • makeinfo --html foo.texi — write HTML
  • makeinfo --xml foo.texi — write Texinfo XML
  • makeinfo --docbook foo.texi — write Docbook XML
  • makeinfo --plaintext foo.texi — write plain text to standard output
  • makeinfo --pdf foo.texi — write PDF using texi2dvi
  • makeinfo --html --no-headers foo.texi — write html without node lines, menus
  • makeinfo --number-sections foo.texi — write Info with numbered sections
  • makeinfo --no-split foo.texi — write one Info file however big

😭 REPORTING BUGS

Email bug reports to bug-texinfo@gnu.org, and general questions and discussion to help-texinfo@gnu.org.

Texinfo home page: https://www.gnu.org/software/texinfo/

👑

Copyright © 2026 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>

This is free software: you are free to change and redistribute it.

There is NO WARRANTY, to the extent permitted by law. (she said what she said, no cap 💀)

🌟 SEE ALSO

The full documentation for texi2any is maintained as a Texinfo manual. If the info and texi2any programs are properly installed at your site, the command

info texi2any

should give you access to the complete manual. iykyk 🧚

and that's the whole page, bestie 💅 this was GNU texinfo 7.3, dated March 2026 — thanks for coming to my TED talk, mwah 🎀✨🦋

📦 where this page comes from