GROFF
Section: User Commands (1)
Updated: 21 December 1999
Index
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)
版权所有 © 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 得到。