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
- 定義 c 或 name
是一個字符串 s; c
必須是單字符的一個名稱
- -E
- 阻止 troff
的錯誤輸出.
注意這不影響發出 tm
或 tm1
請求的宏包發出的錯誤消息向標準錯誤輸出
- -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
意思是列印 m 到 n
之間的所有頁面, -n
意思是列印直到 n
的所有頁面, n-
意思是列印從 n
開始的所有頁面,直到結束.
troff
列印完列表中的最後一頁後將退出
- -rcn
-
- -rname=n
- 設置數字寄存器
c 或 name 為 n; c
必須是單字符的一個名稱,
n 可以是任何 troff
數字表達式
- -R
- 不讀取 troffrc 和
troffrc-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)
而使用了不帶參數的
di 或 da
- 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 的字型檔案
注意預設情況下既不在當前目錄也不在個人目錄搜索
troffrc 和
troffrc-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 This document was written by James Clark, with
modifications from 和
此文件是
groff GNU roff
套件的一部分
參見 SEE ALSO¶
- groff(1)
- groff
系統的主程式, troff
的包裝.
- groff(7)
- groff
語言的描述,包括一個雖然短但是完整的手冊,內容是所有預定義的
請求 (request),寄存器 (register)
和 groff 正文的轉義 (escapes of
plain 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