总览 (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 字体的字体文件。