NAME¶

總覽 SYNOPSIS¶

在一個命令行選項與其參數之間可以有空格。

描述 DESCRIPTION¶

選項 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¶

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¶

此文檔按照 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 文檔整合到了單獨的一篇文檔中

[中文版維護人]¶

[中文版最新更新]¶

《中國linux論壇man手冊翻譯計劃》:¶

跋¶