Home
March 21, 2010 6:05:03 AM EST
home
back print
MAKEINFO   (1) manpage
MAKEINFO
1
September 2008
makeinfo 4.13
User Commands
  • NAME
      makeinfo - 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. "General options:"
      --error-limit=NUM
      quit after NUM errors (default 100).
      --document-language=STR locale to use in translating Texinfo keywords
      for the output document (default C).
      --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).
      -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.
      --xml
      output Texinfo XML rather than Info.
      --plaintext
      output plain text rather than Info. "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, write to standard output by default.
      --no-split
      suppress the splitting of Info or HTML output, generate only one output file.
      --number-sections
      output chapter and sectioning numbers.
      -o, --output=FILE
      output to FILE (or directory if split HTML). "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 reference to a CSS file.
      --internal-links=FILE
      produce list of internal links in FILE.
      --transliterate-file-names
      produce file names in ASCII transliteration. "Options for XML and Docbook:"
      --output-indent=VAL
      indent XML elements by VAL spaces (default 2). If VAL is 0, ignorable whitespace is dropped. "Input file options:"
      --commands-in-node-names
      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:"
      --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; implies --no-split.
      --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 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 --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 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 © 2008 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 makeinfo is maintained as a Texinfo 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.


Current Users: 58 © 1999-2009 PenguinSoft. All trademarks and copyrights on this page are owned by their respective companies. Linux is a trademark of Linus Torvalds.