SYNOPSIS 总览
makeinfo [OPTION]... TEXINFO-FILE...
DESCRIPTION 描述
将 Texinfo 源文档翻译为各种其他格式，默认是可以用 Emacs 或者独立的 GNU Info 查看的，适于在线阅读的 Info 文件。
通用选项：
- --error-limit=NUM
- 在遇到 NUM 个错误后退出。默认是 100。
- --force
- 即使发生错误也保留输出内容。
- --help
- 显示这份帮助，然后退出。
- --no-validate
- 不进行节点交叉引用的验证。
- --no-warn
- 阻止提示警告 (但是不阻止提示错误)。
- --reference-limit=NUM
- 警告达到了引用的最大数量 NUM (默认是 1000)。
- -v, --verbose
- 解释正在做什么。
- --version
- 显示版本信息，然后退出。
输出格式选择 (默认产生 Info)：
- --docbook
- 输出 DocBook XML 而不是 Info。
- --html
- 输出 HTML 而不是 Info。
- --xml
- 输出 Texinfo XML 而不是 Info。
通用输出选项：
- -E, --macro-expand FILE
- 输出扩展了宏的源文件，保存到 FILE。忽略任何 @setfilename。
- --no-headers
- 从 Info 输出中去除节点分隔符，Node:lines 和菜单 (以产生普通文本)，或者从 HTML 输出中去除它们 (以产生短一些的文本)；同时，默认输出到标准输出。
- --no-split
- 阻止拆分 Info 或 HTML 输出，只产生单一的输出文件。
- --number-sections
- 输出章节和段落号。
- -o, --output=FILE
- 输出到文件 FILE (如果拆分 HTML 的话，就表示目录 FILE)。
用于 Info 和普通文本的选项：
- --enable-encoding
- 根据 @documentencoding，在 Info 输出中输出着重符号和特殊字符。
- --fill-column=NUM
- 输出 NUM 个字符之后分行。默认是 72。
- --footnote-style=STYLE
- 根据 STYLE，在 Info 中输出脚注： `separate' 将把它们放在它们自己的节点中； `end' 将把它们放在定义它们的节点
- 的末尾。
- --paragraph-indent=VAL
- 缩进 Info 段落 VAL 个空格，默认是 3。如果 VAL 是 `none'，不进行缩进；如果 VAL 是 `asis'，将维持已有的缩进。
- --split-size=NUM
- 输出 NUM 个字符后拆分新的文件。默认是 300000。
用于 HTML 的选项：
- --css-include=FILE
- 在输出的 HTML <style> 标签中包含 FILE 的内容；如果 FILE 是 `-' 就从标准输入读取。
输入文件选项：
- --commands-in-node-names
- 允许在节点名称中出现 @ 命令。
- -D VAR
- 定义变量 VAR，如同使用了 @set。
- -I DIR
- 将 DIR 添加到 @include 搜索路径中。
- -P DIR
- 将 DIR 添加到 @include 搜索路径之前。
- -U VAR
- 取消变量 VAR 的定义，如同使用了 @clear。
在输入中使用条件处理：
- --ifhtml
- 处理 @ifhtml 和 @html，即使不是在生成 HTML。
- --ifinfo
- 处理 @ifinfo，即使不是在生成 Info。
- --ifplaintext
- 处理 @ifplaintext，即使不是在生成普通文本。
- --iftex
- 处理 @iftex 和 @tex；隐含了 --no-split。
- --ifxml
- 处理 @ifxml 和 @xml。
- --no-ifhtml
- 不处理 @ifhtml 和 ＠html 文本。
- --no-ifinfo
- 不处理 @ifinfo 文本。
- --no-ifplaintext
- 不处理 @ifplaintext 文本。
- --no-iftex
- 不处理 @iftex 和 @tex 文本。
- --no-ifxml
- 不处理 @ifxml 和 @xml 文本。
- @if... 条件语句的默认处理方法取决于输出格式：如果在生成 HTML，--ifhtml 就是打开的，其他的是关闭的；如果在生成 Info，--ifinfo 就是打开的，其他的是关闭的；如果在生成普通文本，--ifplaintext 就是打开的，其他的是关闭的；如果在生成 XML，--ifxml 就是打开的，其他的是关闭的。
EXAMPLES 范例
- makeinfo foo.texi
- 输出 Info，保存为 foo 的 @setfilename 指定的文件
- makeinfo --html foo.texi
- 输出 HTML，保存为 @setfilename
- makeinfo --xml foo.texi
- 输出 XML，保存为 @setfilename
- makeinfo --docbook foo.texi
- 输出 DocBook XML，保存为 @setfilename
- makeinfo --no-headers foo.texi
- 输出普通文本，显示在标准输出上。
- makeinfo --html --no-headers foo.texi 输出没有 node lines 和菜单的 html makeinfo --number-sections foo.texi 输出 Info 并且为段落编号 makeinfo --no-split foo.texi 输出单一的 Info 文件，不管它多大