Provided by: manpages-zh_1.5.2-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

       將使你可以讀取完整的手冊。