GROFF

Section: User Commands (1)
Updated: 21 December 1999
Index Return to Main Contents

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)

u+3n

: /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)

这一程序是自由软件，你可以遵照自由软件基金会出版的 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

This document was created by man2html, using the manual pages.
Time: 13:12:00 GMT, December 24, 2015