Provided by: manpages-zh_1.5.1-1_all bug

NAME

       troff - groff 文件排版系統的 troff 處理器

` SYNOPSIS
       troff [ -abcivzCERU ] [ -dcs ] [ -ffam ] [ -Fdir ] [ -mname ] [ -Mdir ]
             [ -nnum ] [ -olist ] [ -rcn ] [ -Tname ] [ -wname ] [ -Wname ]
             [ files... ]

       在一茤R令行選項與其參數之間可以有空格。

yz DESCRIPTION
       這份手冊韌yz了  GNU  版本的  troff.   它是 groff 文件排版系統的一部分。
       它與  UNIX   troff   的弁酮萛e,但是有很多的擴展,參見   groff_diff(7).
       通常它應當用                  groff(1)                  命令調用,groff
       會以合適的順序和合適的選項,運行預處理器和後處理器。

 OPTIONS
       -a        產生一荓忽擖X的 ASCII 近似結果 (approximation)

       -b        在每條錯誤或警告消息中列印回溯信息  此信息可以幫助跟蹤錯誤的-
                 鴞] 信息中的行號可能有誤,因為 troff 中行號的意義與請求類型是
                 as 還是 am 有關

       -c        禁止顏色輸出 (相容模式下總是禁止)

       -C        使用相容模式

       -dcs
       -dname=s  定義 cname 是一茼r符串 s; c 必須是單字符的一茼W稱

       -E        阻止  troff   的錯誤輸出.    注意這不影響發出   tmtm1
                 請求的宏包發出的錯誤消息向標準錯誤輸出

       -ffam     使用 fam 作為預設字型族

       -Fdir     在目錄中   (或目錄路徑中)   搜索  dir  子目錄  devname  (name
                 是設備的名稱)    查找其中的    DESC    檔案和字型檔案     dir
                 在所有其他字型目錄之前查找

       -i        處理完所有輸入檔案後繼續從標準輸入讀入

       -mname    讀入檔案  name.tmac.  如果沒有找到,則去讀 tmac.name 它將先在
                 -M     命令行參數給定的目錄中搜索,然後是     GROFF_TMAC_PATH
                 環境變量中的目錄,然後是當前目錄     (安全模式不會做這一步),
                 然後是茪H目錄,/usr/lib/groff/site-tmac,
                 /usr/share/groff/site-tmac 還有 /usr/share/groff/1.18.1/tmac.

       -Mdir     搜索目錄         (或目錄路徑)         dir          查找宏檔案
                 檢索在所有其他宏目錄之前進行

       -nnum     為第一飭s號 num.

       -olist    僅輸出  list  中指定的間A參數是一茈H逗號分隔的飧酬圍的列表; n
                 意思是列印雇 n,  m-n  意思是列印  mn  之間的所有雇,  -n
                 意思是列印直到  n  的所有雇,  n-  意思是列印從 n 開始的所有-
                 情A直到結束.  troff 列印完列表中的最後一陲嵿N退出

       -rcn
       -rname=n  設置數字寄存器 cnamen;  c  必須是單字符的一茼W稱,  n
                 可以是任何 troff 數字表達式

       -R        不讀取 troffrctroffrc-end.

       -Tname    為設備 name 而不是預設的 ps 準備輸出

       -U        不全模式   這將允酗U列請求  open,  opena,  pso,  sy,  和  pi.
                 出於安全鴞],這些潛在的危險的請求在其他情況下被禁止。
                 同時它將當前目錄加入宏搜索路徑

       -v        列印版本號

       -wname    允陬o出   name   警告。可能的警告名稱在下悸   i  WARNINGS
                 章節中詳z 例如,n允釧狾傍筆i,使用  -w  all.   允釣洏峖h  -w
                 選項

       -Wname    禁止發出 name 警告。允釣洏峖h -W 選項

       -z        阻止格式化的輸出

i WARNINGS
       troff   可以發出的警告分為下列類別   每種警告關聯的名稱在   -w-W
       選項中使用;關聯的數字被 warn 請求和 .warn 寄存器使用,  它總是  2  的-
       ,以允釵儦B算

                 +---------------------+----------------------------+
                 |Bit   Code   Warning | Bit    Code      Warning   |
                 +---------------------+----------------------------+
                 |  0      1   char    |  10     1024   reg         |
                 |  1      2   number  |  11     2048   tab         |
                 |  2      4   break   |  12     4096   right-brace |
                 |  3      8   delim   |  13     8192   missing     |
                 |  4     16   el      |  14    16384   input       |
                 |  5     32   scale   |  15    32768   escape      |
                 |  6     64   range   |  16    65536   space       |
                 |  7    128   syntax  |  17   131072   font        |
                 |  8    256   di      |  18   262144   ig          |
                 |  9    512   mac     |  19   524288   color       |
                 +---------------------+----------------------------+

       break           4   在填充       (fill)      模式下,不可分行的行的長度
                           比行的長度n小。 In fill mode, lines which could not
                           be  broken  so  that their length was less than the
                           line length.  此警告是預設允釭

       char            1   不存在的字符。 此警告是預設允釭

       color      524288   顏色相關的警告

       delim           8   關閉定界符丟失或不匹配

       di            256   沒有當前轉移 (current diversion) 而使用了不帶參數的
                           dida

       el             16   使用 el 請求但是沒有相應的 ie 請求

       escape      32768   不可識別的轉義序列。                      當遇到一-
                           茪ㄔi識別的轉義序列時,轉義字符被忽略

       font       131072   不存在的字型。 此警告是預設允釭

       ig         262144   ig                     請求忽略的文本中的非法轉義。
                           如果不是在被忽略的文本中,它戔N是錯誤

       input       16384   非法輸入字符

       mac           512   使用未定義的字符串,宏和標號    (diversions)   (?).
                           當使用一茈憬w義的字符串,宏或標號      (diversions)
                           時,字符串被自動定義為空。
                           因此,在大多數情況下,每茼W字最多會給出一蚅筆i

       missing      8192   請求缺少必n的參數

       number          2   非法數竁F式。 此警告是預設允釭

       range          64   超出S圍的參數

       reg          1024   使用未定義的數字寄存器。                  當使用一-
                           茈憬w義的數字寄存器時,寄存器被自動定義為      0。
                           因此,大多數情況下,使用一荅S定的名字最多會得到一-
                           蚅筆i

       right-brace  4096   在應當使用數字的地方使用了 \}

       scale          32   無意義的比例指示 (scaling indicators).

       space       65536   在一蚑虼D或宏與其參數之間缺少空格。    當遇到一茖-
                           茼r符以上的未定義名字,並且名字的前兩茼r符是一-
                           茪w定義的名稱時將給出這蚅筆i,   請求或宏不會執行。
                           當給出這蚅筆i時,不會自動定義宏。
                           此警告是預設允釭滿C 在相容模式下不會發生這種警告

       syntax        128   數竁F式中語法有歧義

       tab          2048   不合適地使用了              tab              字符。
                           在應當使用數字的地方使用了tab字符,或者在一-
                           茈憧恲糷瑏馱犍峈漣趕捊尹洏姾ab 時會發生

       也有可以引用一組警告的名稱

       all    所有的警告,除了         di,         mac,         和        reg.
              它的目的是指代所有在傳統的宏包中有用的警告

       w      所有警告

 ENVIRONMENT
       GROFF_TMAC_PATH
              一茈H冒號分隔的目錄的列表,從中搜索宏檔案  troff   將先搜索   -M
              選項給出的目錄,以及標準的路徑  ( 當前目錄 (如果是不安全模式),-
              茪H目錄  /usr/lib/groff/site-tmac,   /usr/share/groff/site-tmac,
              /usr/share/groff/1.18.1/tmac) 最後搜索它

       GROFF_TYPESETTER
              預設設備

       GROFF_FONT_PATH
              一茈H冒號分隔的目錄的列表,從中搜索    devname    目錄。   troff
              將先搜索            -F            選項給出的目錄,以及標準的路徑
              (/usr/share/groff/site-font,       /usr/share/groff/1.18.1/font,
              /usr/lib/font) 最後搜索它

 FILES
       /usr/share/groff/1.18.1/tmac/troffrc
              初始化檔案 (在任何其他宏包之前調用).

       /usr/share/groff/1.18.1/tmac/troffrc-end
              初始化檔案 (在任何其他宏包之後調用).

       /usr/share/groff/1.18.1/tmac/name.tmac
       /usr/share/groff/1.18.1/tmac/tmac.name
              宏檔案

       /usr/share/groff/1.18.1/font/devname/DESC
              設備 name 的設備描z檔案.

       /usr/share/groff/1.18.1/font/devname/F
              設備 name 的字型 F 的字型檔案

       注意預設情況下既不在當前目錄也不在茪H目錄搜索  troffrctroffrc-end
       ,因為安全的鴞]    (即使給出了    -U    選項)。    如果有必n,使用   -M
       命令行選項或者 GROFF_TMAC_PATH 環境變量來將這些路徑添加到搜索路徑中

@ AUTHOR
       Copyright (C) 1989, 2001, 2002 Free Software Foundation, Inc.

       此文件按照 FDL  (GNU  Free  Documentation  License)  1.1  或更新版本的-
       n求發佈。 You should have received a copy of the FDL on your system, it
       is   also   available   on-line    at    the    GNU    copyleft    site
       <http://www.gnu.org/copyleft/fdl.html>.   This  document was written by
       James Clark, with modifications from  Werner  Lemberg  <wl@gnu.org>  和
       Bernd Warken <bwarken@mayn.de>

       此文件是 groff GNU roff 套件的一部分

 SEE ALSO
       groff(1)
              groff 系統的主程式, troff 的包裝.

       groff(7)
              groff 語言的描z,包括一蚆鷁M短但是完整的手冊,內容是所有預定義的
              請求 (request),寄存器 (register) 和 groff  正文的轉義  (escapes
              of plain groff).  可以在命令行查看,使用命令

                     man 7 groff

       groff_diff(7)
              groff  語言和傳統的  classical  troff  語言不同之處。 當前,這是
              groff 系統最為現實 (actual) 的一篇文件

       roff(7)
              對 groff 和其他 roff 系統的概z,包括更多相關文件的鏈接

       groff    info    file,    參見    (cf.)    info(1),    將所有     groff
       文件整合到了單獨的一篇文件中

[]
       bbbush <bbbush@163.com>

[]
       2003.11.25

mlinuxan:
       http://cmpp.linuxforum.net