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