Provided by: manpages-zh_1.5.2-1.1_all bug

NAME

       makeinfo - 翻译 Texinfo 文档

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 文件,不管它多大

REPORTING BUGS 报告错误

       将错误报告发送到   bug-texinfo@gnu.org,一般的问题和讨论则发送到    help-texinfo@gnu.org。
       Texinfo 主页:http://www.gnu.org/software/texinfo/

COPYRIGHT

       Copyright  ©  2003  Free  Software  Foundation,  Inc.   There  is  NO  warranty.   You may
       redistribute this software under the terms of the GNU General Public  License.   For  more
       information about these matters, see the files named COPYING.

SEE ALSO 参见

       install-info   的全部文档以   Texinfo   手册页形式保存。如果你的主机上正确安装了  infoinstall-info 程序,命令

              info install-info

       将使你可以读取完整的手册。