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

NAME

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

總覽 SYNOPSIS

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

       在一個命令列選項與其引數之間可以有空格。

描述 DESCRIPTION

       這份手冊頁描述了 GNU 版本的 troff.  它是 groff 文件排版系統的一部分。 它與 UNIX troff 的功
       能相容,但是有很多的擴充套件,參見  groff_diff(7).   通常它應當用 groff(1) 命令呼叫,groff
       會以合適的順序和合適的選項,執行預處理器和後處理器。

選項 OPTIONS

       -a        產生一個排版輸出的 ASCII 近似結果 (approximation)

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

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

       -C        使用相容模式

       -dcs
       -dname=s  定義 cname 是一個字串 s; c 必須是單字元的一個名稱

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

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

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

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

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

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

       -nnum     為第一頁編號 num.

       -olist    僅輸出 list 中指定的頁,引數是一個以逗號分隔的頁號範圍的列表;  n  意思是列印頁面
                 n, m-n 意思是列印 mn 之間的所有頁面, -n 意思是列印直到 n 的所有頁面, n- 意思
                 是列印從 n 開始的所有頁面,直到結束.  troff 列印完列表中的最後一頁後將退出

       -rcn
       -rname=n  設定數字暫存器 cnamen; c 必須是單字元的一個名稱, n 可以是任何 troff  數
                 字表達式

       -R        不讀取 troffrctroffrc-end.

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

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

       -v        列印版本號

       -wname    允許發出 name 警告。可能的警告名稱在下面的 警告 WARNINGS 章節中詳述 例如,要允許
                 所有警告,使用 -w all.  允許使用多個 -w 選項

       -Wname    禁止發出 name 警告。允許使用多個 -W 選項

       -z        阻止格式化的輸出

警告 WARNINGS

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

                          ┌─────────────────────┬────────────────────────────┐
                          │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)  模式下,不可分行的行的長度  比行的長度要小。  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   不可識別的轉義序列。 當遇到一個不可識別的轉義序列時,跳脫字元被忽略

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

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

       input       16384   非法輸入字元

       mac           512   使用未定義的字串,宏和標號  (diversions)  (?).    當使用一個未定義的字
                           串,宏或標號  (diversions) 時,字串被自動定義為空。 因此,在大多數情況
                           下,每個名字最多會給出一個警告

       missing      8192   請求缺少必要的引數

       number          2   非法數值表示式。 此警告是預設允許的

       range          64   超出範圍的引數

       reg          1024   使用未定義的數字暫存器。  當使用一個未定義的數字暫存器時,暫存器被自動
                           定義為值  0。 因此,大多數情況下,使用一個特定的名字最多會得到一個警告

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

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

       space       65536   在一個請求或宏與其引數之間缺少空格。  當遇到一個兩個字元以上的未定義名
                           字,並且名字的前兩個字元是一個已定義的名稱時將給出這個警告,  請求或宏
                           不會執行。  當給出這個警告時,不會自動定義宏。 此警告是預設允許的。 在
                           相容模式下不會發生這種警告

       syntax        128   數值表示式中語法有歧義

       tab          2048   不合適地使用了 tab 字元。  在應當使用數字的地方使用了tab字元,或者在一
                           個未用雙引號引用的宏引數中使用tab 時會發生

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

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

       w      所有警告

環境 ENVIRONMENT

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

       GROFF_TYPESETTER
              預設裝置

       GROFF_FONT_PATH
              一個以冒號分隔的目錄的列表,從中搜索  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 的裝置描述檔案.

       /usr/share/groff/1.18.1/font/devname/F      裝置 name 的字型 F 的字型檔案

       注意預設情況下既不在當前目錄也不在個人目錄搜尋 troffrctroffrc-end ,因為安全的原因 (即
       使給出了 -U 選項)。 如果有必要,使用 -M 命令列選項或者 GROFF_TMAC_PATH  環境變數來將這些路
       徑新增到搜尋路徑中

作者 AUTHOR

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

       此文件按照 FDL (GNU Free Documentation License) 1.1 或更新版本的要求釋出。 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       語言的描述,包括一個雖然短但是完整的手冊,內容是所有預定義的       請求
              (request),暫存器 (register) 和 groff 正文的轉義 (escapes of plain groff).   可以在
              命令列檢視,使用命令

                     man 7 groff

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

       roff(7)
              對 groff 和其他 roff 系統的概述,包括更多相關文件的連結

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

[中文版維護人]

       bbbush <bbbush@163.com>

[中文版最新更新]

       2003.11.25

《中國linux論壇man手冊翻譯計劃》:

       http://cmpp.linuxforum.net

       本頁面中文版由中文 man 手冊頁計劃提供。
       中文 man 手冊頁計劃:https://github.com/man-pages-zh/manpages-zh