Copyright (C) 1992, 1993 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.
This file documents the use of the
makeinfo program, versions
1.51 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
learn about Info.
See the Texinfo manual,
to learn about the Texinfo documentation system.
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
@set varin the Texinfo file.
makeinfowill report before exiting (on the assumption that continuing would be useless). The default number of errors that can be reported before
makeinfogives up is 100.
@footnotestylecommand. When the footnote style is `separate',
makeinfomakes a new node containing the footnotes found in the current node. When the footnote style is `end',
makeinfoplaces the footnote references at the end of the current node.
dirto the directory search list for finding files that are included using the
@includecommand. By default,
makeinfosearches only the current directory.
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',
makeinfowill not split up the output file.
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.
makeinfonumbers each footnote sequentially in a single node, resetting the current footnote number to 1 at the start of each node.
@setfilenamecommand found in the Texinfo source. file can be the special token `-', which specifies standard output.
@paragraphindentcommand. The value of indent is interpreted as follows:
makeinfowill make without reporting a warning. If a node has more than this number of references in it,
makeinfowill make the references but also report a warning.
@clear varin the Texinfo file.
makeinfoto display messages saying what it is doing. Normally,
makeinfoonly outputs messages if there are errors or warnings.
If you do not suppress pointer-validation (by using the
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