Rechercher une page de manuel
makeinfo
Langue: en
Version: September 2008 (fedora - 01/12/10)
Section: 1 (Commandes utilisateur)
Sommaire
NAME
makeinfo - translate Texinfo documentsSYNOPSIS
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.
Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre