TROFF(1) | General Commands Manual | TROFF(1) |
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 時會發生
也有可以引用一組警告的名稱
環境 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). 可以在命令行查看,使用命令
- 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手冊翻譯計劃》:¶
跋¶
本頁面中文版由中文
man 手冊頁計劃提供。
中文 man
手冊頁計劃:https://github.com/man-pages-zh/manpages-zh
16 September 2002 | Groff Version 1.18.1 |