Provided by:
manpages-zh_1.5.1-2_all 
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 定義 c 或 name 是一茼r符串 s; c 必須是單字符的一茼W稱
-E 阻止 troff 的錯誤輸出. 注意這不影響發出 tm 或 tm1
請求的宏包發出的錯誤消息向標準錯誤輸出
-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 意思是列印 m 到 n 之間的所有雇, -n
意思是列印直到 n 的所有雇, n- 意思是列印從 n 開始的所有-
情A直到結束. troff 列印完列表中的最後一陲嵿N退出
-rcn
-rname=n 設置數字寄存器 c 或 name 為 n; c 必須是單字符的一茼W稱， n
可以是任何 troff 數字表達式
-R 不讀取 troffrc 和 troffrc-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) 而使用了不帶參數的
di 或 da
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目錄搜索 troffrc 和 troffrc-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