MirBSD manpage: makeinfo(1)

MAKEINFO(1)               User Commands               MAKEINFO(1)


     makeinfo - translate Texinfo documents


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


     Translate Texinfo source documentation to various other for-
     mats, by default Info files suitable for reading online with
     Emacs or standalone GNU Info.

     General options:

          quit after NUM errors (default 100).

          preserve output even if errors.

          display this help and exit.

          suppress node cross-reference validation.

          suppress warnings (but not errors).

          warn about at most NUM references (default 1000).

     -v, --verbose
          explain what is being done.

          display version information and exit.

     Output format selection (default is to produce Info):

          output Docbook XML rather than Info.

          output HTML rather than Info.

          output Texinfo XML rather than Info.

          output plain text rather than Info.

makeinfo 4.8              December 2004                         1

MAKEINFO(1)               User Commands               MAKEINFO(1)

     General output options:

     -E, --macro-expand FILE
          output macro-expanded source to FILE. ignoring any

          suppress node separators, Node: lines, and menus from
          Info output (thus producing plain text) or from HTML
          (thus producing shorter output); also, write to stan-
          dard output by default.

          suppress splitting of Info or HTML output, generate
          only one output file.

          output chapter and sectioning numbers.

     -o, --output=FILE
          output to FILE (directory if split HTML),

     Options for Info and plain text:

          output accented and special characters in Info output
          based on @documentencoding.

          break Info lines at NUM characters (default 72).

          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 (default).

          indent Info paragraphs by VAL spaces (default 3). If
          VAL is `none', do not indent; if VAL is `asis',
          preserve existing indentation.

          split Info files at size NUM (default 300000).

     Options for HTML:

          include FILE in HTML <style> output; read stdin if FILE
          is -.

makeinfo 4.8              December 2004                         2

MAKEINFO(1)               User Commands               MAKEINFO(1)

     Options for XML and Docbook:

          indent XML elements by VAL spaces (default 2). If VAL
          is 0, ignorable whitespace is dropped.

     Input file options:

          allow @ commands in node names.

     -D VAR
          define the variable VAR, as with @set.

     -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:

          process @ifdocbook and @docbook even if not generating

          process @ifhtml and @html even if not generating HTML.

          process @ifinfo even if not generating Info.

          process @ifplaintext even if not generating plain text.

          process @iftex and @tex; implies --no-split.

          process @ifxml and @xml.

          do not process @ifdocbook and @docbook text.

          do not process @ifhtml and @html text.

          do not process @ifinfo text.

makeinfo 4.8              December 2004                         3

MAKEINFO(1)               User Commands               MAKEINFO(1)

          do not process @ifplaintext text.

          do not process @iftex and @tex text.

          do not process @ifxml and @xml text.

          Also, for the --no-ifFORMAT options, do process @ifnot-
          FORMAT text.

          The defaults for the @if... conditionals depend on the
          output format: 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 generat-
          ing XML, --ifxml is on and the others are off.


     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 --no-headers foo.texi
          write plain text to standard output

          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 how-
          ever big


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


     Copyright (C) 2004 Free Software Foundation, Inc. There is
     NO warranty.  You may redistribute this software under the
     terms of the GNU General Public License. For more informa-
     tion about these matters, see the files named COPYING.

makeinfo 4.8              December 2004                         4

MAKEINFO(1)               User Commands               MAKEINFO(1)


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

          info makeinfo

     should give you access to the complete manual.

makeinfo 4.8              December 2004                         5

Generated on 2022-12-24 01:00:14 by $MirOS: src/scripts/roff2htm,v 1.113 2022/12/21 23:14:31 tg Exp $ — This product includes material provided by mirabilos.

These manual pages and other documentation are copyrighted by their respective writers; their sources are available at the project’s CVSweb, AnonCVS and other mirrors. The rest is Copyright © 2002–2022 MirBSD.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report — diffs preferred.

Kontakt / Impressum & Datenschutzerklärung