groff − groff 文档排版系统前端
groff [ −abehilpstvzCENRSUVXZ ] [ −wname ] [ −Wname ] [ −mname ] [ −Fdir ] [ −Idir ] [ −Tdev ] [ −ffam ] [ −Mdir ] [ −dcs ] [ −rcn ] [ −nnum ] [ −olist ] [ −Parg ] [ −Larg ] [ files... ]
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 命令。
−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) 中描述。 |
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) 命令都会创建临时文件。
/usr/lib/groff/font/devname/DESC |
name 设备的设备描述文件。 |
||
/usr/lib/groff/font/devname/F |
name 设备的 F 字体的字体文件。 |
James Clark <jjc AT jclark DOT com>
报错误报告给 bug-groff AT gnu DOT org。 请包含一个完整的报告, 还有一个能使错误再次出现的例子, 并注明用的是 groff 的哪个版本。
版权所有 © 1989, 1990, 1991, 1992, 1999 自由软件基金会
这一程序是自由软件, 你可以遵照自由软件基金会出版的 GNU 通用公共许可 证条款来修改和重新发布这一程序。 或者用许可证的第二版, 或者(根据你的选 择)用任何更新的版本。
发布 groff 程序的目的是希望它有用, 但没有任何担保。 甚至没有适合特定目 的的隐含的担保。 更详细的情况请参阅 GNU 通用公共许可证。
你应该已经和程序一起收到一份 GNU 通用公共许可证的副本。 如果还没有, 写信给: The Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA02139, USA
groff 的最新版本可以通过匿名 ftp 从 ftp.gnu.org/gnu/groff 得到。
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 AT 263 DOT net>
2001/8/29
http://cmpp.linuxforum.net
本页面中文版由中文 man 手册页计划提供。
中文 man 手册页计划:https://github.com/man-pages-zh/manpages-zh