GROFF(1)

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。

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)

[中文版維護人]
唐友 <tony_ty@263.net>

[中文版最新更新]
2001/8/29

[中國Linux論壇man手冊頁翻譯計劃]
http://cmpp.linuxforum.net

跋
本頁面中文版由中文 man 手冊頁計劃提供。
中文 man 手冊頁計劃：https://github.com/man-pages-zh/manpages-zh