1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.24.
2 .TH MAKEINFO "1" "April 2002" "GNU texinfo 4.2" FSF
4 makeinfo \- translate Texinfo documents
7 [\fIOPTION\fR]... \fITEXINFO-FILE\fR...
9 Translate Texinfo source documentation to various other formats, by default
10 Info files suitable for reading online with Emacs or standalone GNU Info.
11 .SS "General options:"
13 \fB\-\-error\-limit\fR=\fINUM\fR
14 quit after NUM errors (default 100).
17 preserve output even if errors.
20 display this help and exit.
22 \fB\-\-no\-validate\fR
23 suppress node cross-reference validation.
26 suppress warnings (but not errors).
28 \fB\-\-reference\-limit\fR=\fINUM\fR
29 warn about at most NUM references (default 1000).
31 \fB\-v\fR, \fB\-\-verbose\fR
32 explain what is being done.
35 display version information and exit.
36 .SS "Output format selection (default is to produce Info):"
39 output DocBook rather than Info.
42 output HTML rather than Info.
45 output XML (TexinfoML) rather than Info.
46 .SS "General output options:"
48 \fB\-E\fR, \fB\-\-macro\-expand\fR FILE
49 output macro-expanded source to FILE.
50 ignoring any @setfilename.
53 suppress node separators, Node: lines, and menus
54 from Info output (thus producing plain text)
55 or from HTML (thus producing shorter output);
56 also, write to standard output by default.
59 suppress splitting of Info or HTML output,
60 generate only one output file.
62 \fB\-\-number\-sections\fR
63 output chapter and sectioning numbers.
65 \fB\-o\fR, \fB\-\-output\fR=\fIFILE\fR
66 output to FILE (directory if split HTML),
67 .SS "Options for Info and plain text:"
69 \fB\-\-enable\-encoding\fR
70 output accented and special characters in
71 Info output based on @documentencoding.
73 \fB\-\-fill\-column\fR=\fINUM\fR
74 break Info lines at NUM characters (default 72).
76 \fB\-\-footnote\-style\fR=\fISTYLE\fR
77 output footnotes in Info according to STYLE:
78 `separate' to put them in their own node;
79 `end' to put them at the end of the node
81 in which they are defined (default).
83 \fB\-\-paragraph\-indent\fR=\fIVAL\fR
84 indent Info paragraphs by VAL spaces (default 3).
85 If VAL is `none', do not indent; if VAL is
86 `asis', preserve existing indentation.
88 \fB\-\-split\-size\fR=\fINUM\fR
89 split Info files at size NUM (default 50000).
90 .SS "Input file options:"
92 \fB\-\-commands\-in\-node\-names\fR
93 allow @ commands in node names.
96 define the variable VAR, as with @set.
99 append DIR to the @include search path.
102 prepend DIR to the @include search path.
105 undefine the variable VAR, as with @clear.
106 .SS "Conditional processing in input:"
109 process @ifhtml and @html even if not generating HTML.
112 process @ifinfo even if not generating Info.
114 \fB\-\-ifplaintext\fR
115 process @ifplaintext even if not generating plain text.
118 process @iftex and @tex; implies \fB\-\-no\-split\fR.
121 do not process @ifhtml and @html text.
124 do not process @ifinfo text.
126 \fB\-\-no\-ifplaintext\fR
127 do not process @ifplaintext text.
130 do not process @iftex and @tex text.
132 The defaults for the @if... conditionals depend on the output format:
133 if generating HTML, \fB\-\-ifhtml\fR is on and the others are off;
134 if generating Info, \fB\-\-ifinfo\fR is on and the others are off;
135 if generating plain text, \fB\-\-ifplaintext\fR is on and the others are off;
139 write Info to foo's @setfilename
141 makeinfo \fB\-\-html\fR foo.texi
142 write HTML to @setfilename
144 makeinfo \fB\-\-xml\fR foo.texi
145 write XML to @setfilename
147 makeinfo \fB\-\-docbook\fR foo.texi
148 write DocBook XML to @setfilename
150 makeinfo \fB\-\-no\-headers\fR foo.texi
151 write plain text to standard output
153 makeinfo \fB\-\-html\fR \fB\-\-no\-headers\fR foo.texi write html without node lines, menus
154 makeinfo \fB\-\-number\-sections\fR foo.texi write Info with numbered sections
155 makeinfo \fB\-\-no\-split\fR foo.texi write one Info file however big
157 Email bug reports to bug-texinfo@gnu.org,
158 general questions and discussion to help-texinfo@gnu.org.
159 Texinfo home page: http://www.gnu.org/software/texinfo/
161 Copyright \(co 2002 Free Software Foundation, Inc.
162 There is NO warranty. You may redistribute this software
163 under the terms of the GNU General Public License.
164 For more information about these matters, see the files named COPYING.
166 The full documentation for
168 is maintained as a Texinfo manual. If the
172 programs are properly installed at your site, the command
176 should give you access to the complete manual.