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