@paragraphindent none
@dircategory Texinfo documentation system @direntry * makeinfo: (makeinfo). Convert Texinfo source to Info or plain ASCII.
Copyright (C) 1992, 1993, 1994, 1995 Free Software Foundation, Inc.
Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies.
Permission is granted to copy and distribute modified versions of this manual under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one.
Permission is granted to copy and distribute translations of this manual into another language, under the above conditions for modified versions, except that this permission notice may be stated in a translation approved by the Free Software Foundation.
makeinfo
?
This file documents the use of the makeinfo
program, versions
1.61 and later. It is an extract from the Texinfo manual.
makeinfo
is a program for converting Texinfo files into Info
files. Texinfo is a documentation system that uses a single source file to
produce both on-line information and printed output.
You can read the on-line information using Info; type info
to
learn about Info.
See the Texinfo manual,
to learn about the Texinfo documentation system.
Without any special options, makeinfo
fills the paragraphs that
it outputs to an Info file. Filling is the process of breaking and connecting
lines so that lines are the same length as or shorter than the number
specified as the fill column. Lines are broken between words. With
makeinfo
, you can control:
The following command line options are available for makeinfo
.
-D var
@set var
in the Texinfo file.
--error-limit limit
makeinfo
will report
before exiting (on the assumption that continuing would be useless).
The default number of errors that can be reported before
makeinfo
gives up is 100.
--fill-column width
fill-column
is 72.
--footnote-style style
@footnotestyle
command. When the footnote style is
`separate', makeinfo
makes a new node containing the
footnotes found in the current node. When the footnote style is
`end', makeinfo
places the footnote references at the end
of the current node.
-I dir
dir
to the directory search list for finding files that are
included using the @include
command. By default,
makeinfo
searches only the current directory.
--no-headers
--no-split
makeinfo
. Normally, large
output files (where the size is greater than 70k bytes) are split into
smaller subfiles, each one approximately 50k bytes. If you specify
`--no-split', makeinfo
will not split up the output
file.
--no-pointer-validate
--no-validate
makeinfo
. Normally,
after a Texinfo file is processed, some consistency checks are made to
ensure that cross references can be resolved, etc.
See section Pointer Validation.
--no-warn
--no-number-footnotes
makeinfo
numbers each footnote sequentially in a single node, resetting the
current footnote number to 1 at the start of each node.
--output file
-o file
@setfilename
command found in the Texinfo
source. file can be the special token `-', which specifies
standard output.
--paragraph-indent indent
@paragraphindent
command. The value of indent is
interpreted as follows:
--reference-limit limit
makeinfo
will make without reporting a warning. If a node has more
than this number of references in it, makeinfo
will make the
references but also report a warning.
-U var
@clear var
in the Texinfo file.
--verbose
makeinfo
to display messages saying what it is doing.
Normally, makeinfo
only outputs messages if there are errors or
warnings.
--version
makeinfo
.
--help
makeinfo
.
If you do not suppress pointer-validation (by using the
`--no-pointer-validation' option), makeinfo
will check the validity of the final Info file. Mostly,
this means ensuring that nodes you have referenced
really exist. Here is a complete list of what is
checked:
@lowersections
Go to the first, previous, next, last section, table of contents.