总览 (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