總覽 (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。
- GROFF_TMAC_PATH
- 一個冒號分開的列表，
包含尋找宏檔案的路徑。
- GROFF_TYPESETTER
- 預設裝置。
- GROFF_FONT_PATH
- 一個冒號分開的列表，
包含尋找 devname
的路徑。
- PATH
- groff
執行命令的搜尋路徑。
- GROFF_TMPDIR
- 臨時檔案目錄。
如果沒有設定此變數但是設定了
TMPDIR
臨時檔案就會在那個目錄中建立。
否則臨時檔案就會在
/tmp 中建立。 grops(1) 和
refer(1)
命令都會建立臨時檔案。
檔案 (FILES)
- /usr/lib/groff/font/devname/DESC
- name
裝置的裝置描述檔案。
- /usr/lib/groff/font/devname/F
- name 裝置的 F
字型的字型檔案。
作者 (AUTHOR)
James Clark <jjc@jclark.com>
錯誤 (BUGS)
報錯誤報告給
bug-groff@gnu.org。
請包含一個完整的報告，
還有一個能使錯誤再次出現的例子，
並註明用的是 groff
的哪個版本。
版權 (COPYRIGHT)
版權所有 © 1989, 1990, 1991, 1992,
1999 自由軟體基金會
這一程式是自由軟體，
你可以遵照自由軟體基金會出版的
GNU 通用公共許可
證條款來修改和重新發布這一程式。
或者用許可證的第二版，
或者（根據你的選
擇）用任何更新的版本。
釋出 groff
程式的目的是希望它有用，
但沒有任何擔保。
甚至沒有適合特定目
的的隱含的擔保。
更詳細的情況請參閱 GNU
通用公共許可證。
你應該已經和程式一起收到一份
GNU
通用公共許可證的副本。
如果還沒有，
寫信給： The Free Software Foundation, Inc., 675
Mass Ave, Cambridge, MA02139, USA
獲取 (AVAILABILITY)
groff
的最新版本可以透過匿名
ftp 從 ftp.gnu.org/gnu/groff 得到。
參見 (SEE ALSO)
grog(1), troff(1), tbl(1), pic(1),
eqn(1), soelim(1), refer(1), grops(1),
grodvi(1), grotty(1), grohtml(1), gxditview(1),
groff_font(5), groff_out(5), groff_man(7),
groff_ms(7), groff_me(7), groff_char(7),
groff_msafer(7)
http://cmpp.linuxforum.net
跋
本頁面中文版由中文
man 手冊頁計劃提供。
中文 man
手冊頁計劃：https://github.com/man-pages-zh/manpages-zh