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 |