groff

NAME

groff - groff 文件排版系統前端

總覽 (SYNOPSIS)

groff [ -abehilpstvzCENRSUVXZ ] [ -wname ] [ -Wname ] [ -mname ] [ -Fdir ] [ -Idir ] [ -Tdev ] [ -ffam ] [ -Mdir ] [ -dcs ] [ -rcn ] [ -nnum ] [ -olist ] [ -Parg ] [ -Larg ] [ files... ]

描述 (DESCRIPTION)

groff 是 groff 文件排版系統的前端。一般來說，它執行 troff 程式和一個同選擇的裝置相對應的後處理器。可選的裝置有

ps: PostScript 印表機和檢視器。

dvi: TeX dvi 格式。

X75: 一個 75 點每英寸的 X11 檢視器。

X100: 一個 100 點每英寸的 X11 檢視器。

ascii: 打字機一類的裝置。

latin1: 用 ISO Latin-1 字符集的打字機裝置。

lj4: 一個相容 HP LaserJet4 的(或者其它相容 PCL5 的) 印表機。

html: 輸出 HTML 格式。

在裝置描述檔案裡，裝置的後處理器是透過 postpro 命令指定的。這個可以被 -X 選項改寫。

預設的裝置是 ps。它可以選擇用 pic, eqn, tbl, refer, 或者 soelim 等預處理器。

如果沒有任何選項，可以用一個單獨的 - 來代替。檔名 - 代表標準輸入。

grog 命令可以根據檔案格式猜測相應的 groff 命令。

選項 (OPTIONS)

-h: 列印幫助資訊。

-e: 用 eqn 預處理。

-t: 用 tbl 預處理。

-p: 用 pic 預處理。

-s: 用 soelim 預處理。

-Idir: 此選項在 soelim(1) 中描述。此選項包含 -s 選項。

-R: 用 refer 預處理。沒有傳輸引數給 refer 的機制，因為很多 refer 選項在檔案裡有相應的命令。細節請參照 refer(1)。

-v: 使 groff 執行的程式打印出版本號。

-V: 在標準輸出列印管道線，而不執行它。

-z: 禁止 troff 輸出。只有出錯資訊顯示出來。

-Z: 不後處理 troff 的輸出。一般 groff 會自動執行相應的後處理器。

-Parg: 把 arg 傳給後處理器。每個引數都要用單獨的 -P 選項分開。注意 groff 在傳 arg 給後處理器時不會在前加上 - 。

-l: 把輸出送到印表機，所用的命令在裝置描述檔案中用 print 命令分開。

-Larg: 把 arg 傳給印表機。每個引數都要用單獨的 -L 選項分開。注意 groff 在傳 arg 給後處理器時不會在前加上 - 。

-Tdev: 生成針對 dev 裝置的輸出。預設的裝置是 ps。

-X: 用 gxditview 預覽，而不是用一般的後處理器。 Groff 會傳給 gxditview 一個 -printCommand 選項，這樣如果有 -l 選項 Print 就會做 groff 會做的事。除非有 -Tps 選項，否則這並不能產生好的輸出。

-N: 在 eqn 分割符出不產生新行符（newline）。這個同 eqn 中的 -N 選項有一樣的作用。

-S: 安全模式。把 -S 選項傳給 pic 並且對 troff 用 -msafer 宏。（預設開啟）

-U: 不安全模式。用以前的不安全的特性。

-a

-b

-i

-C

-E

-wname

-Wname

-mname

-olist

-dcs

-rcn

-Fdir

-Mdir

-ffam

-nnum: 這些都在 troff(1) 中描述。

環境 (ENVIRONMENT)

GROFF_COMMAND_PREFIX: 如果這個變數設為 X， groff 會執行 Xtroff，而不是 troff。這也適用於 tbl， pic， eqn， refer，和 soelim。但並不適用於 grops， grodvi， grotty， grolj4， grohtml，和 gxditview。