makeinfo --version (return code: 0)
texi2any (GNU texinfo) 6.4.90
Copyright (C) 2017 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://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.
makeinfo --help (return code: 0)
Usage: makeinfo [OPTION]... TEXINFO-FILE...
Translate Texinfo source documentation to various other formats, by default
Info files suitable for reading online with Emacs or standalone GNU Info.
This program is commonly installed as both `makeinfo' and `texi2any';
the behavior is identical, and does not depend on the installed name.
General options:
--document-language=STR locale to use in translating Texinfo keywords
for the output document (default C).
--error-limit=NUM quit after NUM errors (default 100).
--force preserve output even if errors.
--help display this help and exit.
--no-validate suppress node cross-reference validation.
--no-warn suppress warnings (but not errors).
--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 customization variable VAR
to value VAL.
-v, --verbose explain what is being done.
--version display version information and exit.
Output format selection (default is to produce Info):
--docbook output Docbook XML rather than Info.
--html output HTML rather than Info.
--plaintext output plain text rather than Info.
--xml output Texinfo XML rather than Info.
--dvi, --dvipdf, --ps, --pdf call texi2dvi to generate given output,
after checking validity of TEXINFO-FILE.
General output options:
-E, --macro-expand=FILE output macro-expanded source to FILE,
ignoring any @setfilename.
--no-headers suppress node separators, Node: lines, and menus
from Info output (thus producing plain text)
or from HTML (thus producing shorter output).
Also, if producing Info, 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.
-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.
Options for Info and plain text:
--disable-encoding do not output accented and special characters
in Info output based on @documentencoding.
--enable-encoding override --disable-encoding (default).
--fill-column=NUM break Info lines at NUM characters (default 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 is the default).
--paragraph-indent=VAL indent Info paragraphs by VAL spaces (default 3).
If VAL is `none', do not indent; if VAL is
`asis', preserve existing indentation.
--split-size=NUM split Info files at size NUM (default 300000).
Options for HTML:
--css-include=FILE include FILE in HTML <style> output;
read stdin if FILE is -.
--css-ref=URL generate CSS reference to URL.
--internal-links=FILE produce 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; default is set only if split.
Options for XML and Docbook:
--output-indent=VAL does nothing, retained for compatibility.
Options for DVI/PS/PDF:
--Xopt=OPT pass OPT to texi2dvi; can be repeated.
Input file options:
--commands-in-node-names does nothing, retained for compatibility.
-D VAR define the variable VAR, as with @set.
-D 'VAR VAL' define VAR to VAL (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 even if
not generating Docbook.
--ifhtml process @ifhtml and @html even if not generating HTML.
--ifinfo process @ifinfo even if not generating Info.
--ifplaintext process @ifplaintext even if not generating plain text.
--iftex process @iftex and @tex.
--ifxml process @ifxml and @xml.
--no-ifdocbook do not process @ifdocbook and @docbook text.
--no-ifhtml do not process @ifhtml and @html text.
--no-ifinfo do not process @ifinfo text.
--no-ifplaintext do not process @ifplaintext text.
--no-iftex do not process @iftex and @tex text.
--no-ifxml do not process @ifxml and @xml text.
Also, for the --no-ifFORMAT options, do process @ifnotFORMAT text.
The defaults for the @if... conditionals depend on the output format:
if generating Docbook, --ifdocbook is on and the others are off;
if generating HTML, --ifhtml is on and the others are off;
if generating Info, --ifinfo is on and the others are off;
if generating plain text, --ifplaintext is on and the others are off;
if generating XML, --ifxml is on and the others are off.
Examples:
makeinfo foo.texi write Info to foo's @setfilename
makeinfo --html foo.texi write HTML to @setfilename
makeinfo --xml foo.texi write Texinfo XML to @setfilename
makeinfo --docbook foo.texi write Docbook XML to @setfilename
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
Email bug reports to bug-texinfo@gnu.org,
general questions and discussion to help-texinfo@gnu.org.
Texinfo home page: http://www.gnu.org/software/texinfo/