Provided by: texinfo_6.7.0.dfsg.2-5_amd64 bug

NAME

       texi2any - translate Texinfo documents

SYNOPSIS

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

DESCRIPTION

       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

REPORTING BUGS

       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/

COPYRIGHT

       Copyright © 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.

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.