troff - groff 文件排版系統的 troff
處理器
troff [
-abcivzCERU ] [
-dcs ] [
-ffam ] [
-Fdir ] [
-mname ] [
-Mdir ] [
-nnum ] [
-olist ] [
-rcn ] [
-Tname ] [
-wname ]
[
-Wname ] [
files... ]
在一個命令列選項與其引數之間可以有空格。
這份手冊頁描述了 GNU
版本的
troff. 它是 groff
文件排版系統的一部分。
它與 UNIX troff
的功能相容，但是有很多的擴充套件，參見
groff_diff(7). 通常它應當用
groff(1) 命令呼叫，groff
會以合適的順序和合適的選項，執行預處理器和後處理器。
- -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
- 阻止格式化的輸出
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
- 所有警告
- 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) 最後搜尋它
- /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
環境變數來將這些路徑新增到搜尋路徑中
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
套件的一部分
-
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 <[email protected]>
2003.11.25
http://cmpp.linuxforum.net
本頁面中文版由中文 man
手冊頁計劃提供。
中文 man 手冊頁計劃：
https://github.com/man-pages-zh/manpages-zh