6.38. Groff-1.18.1.1
最后更新于：2022-04-01 22:50:22
# 6.38\. Groff-1.18.1.1
Groff 软件包包含几个处理和格式化文本的程序。Groff 把标准的文本和特殊的命令翻译成格式化的输出，就像你在 man 手册页里看到的那样。
**预计编译时间：** 0.4 SBU**所需磁盘空间：** 39.2 MB
## 6.38.1\. 安装 Groff
应用下面的patch来添加 "ascii8" 和 "nippon" 设备到 Groff：
```
patch -Np1 -i ../groff-1.18.1.1-debian_fixes-1.patch
```
### 注意
这些设备在转换一些非 ISO-8859-1 编码的非英语的 man 手册页时，会用到。现在对于 Groff-1.19.x 没有同样功能的patch：
许多屏幕字体没有 Unicode 的单引号和破折号。告诉 Groff 使用等价的 ASCII 字符：
```
sed -i -e 's/2010/002D/' -e 's/2212/002D/' \
-e 's/2018/0060/' -e 's/2019/0027/' font/devutf8/R.proto
```
Groff 希望环境变量 `PAGE` 包含缺省的纸张尺寸。对于在美国的人来说，应当使用 _`PAGE=letter`_ ，如果你住在其他地方，可能需要把 _`PAGE=letter`_ 改成 _`PAGE=A4`_ 。
为编译 Groff 做准备：
```
PAGE= ./configure --prefix=/usr --enable-multibyte
```
编译软件包：
```
make
```
这个软件包没有附带测试程序。
安装软件包：
```
make install
```
有些文档程序，比如 `xman` ，没有下面的符号链接会不能正常工作：
```
ln -sv eqn /usr/bin/geqn
ln -sv tbl /usr/bin/gtbl
```
## 6.38.2\. Groff 的内容
**安装的程序：** addftinfo, afmtodit, eqn, eqn2graph, geqn(→eqn), grn, grodvi, groff, groffer, grog, grolbp, grolj4, grops, grotty, gtbl(→tbl), hpftodit, indxbib, lkbib, lookbib, mmroff, neqn, nroff, pfbtops, pic, pic2graph, post-grohtml, pre-grohtml, refer, soelim, tbl, tfmtodit, troff
### 简要描述
| | |
| --- | --- |
| `addftinfo` | 读取一个 troff 字体文件并增加一些 `groff` 系统使用的附加点阵字体。 |
| `afmtodit` | 建立同 `groff` 和 `grops` 一起使用的字体文件。 |
| `eqn` | 将嵌于 troff 输入文件中的方程描述翻译成 `troff` 能够理解的命令 |
| `eqn2graph` | 把 EQN 等式转换成反图像 |
| `geqn` | 指向 `eqn` 的连接 |
| `grn` | `groff` 的 gremlin 文件预处理器 |
| `grodvi` | `groff` 的产生 TeX dvi 格式的驱动 |
| `groff` | groff 文档格式系统的前端。通常它调用 `troff` 程序和对指定设备适用的后处理器 |
| `groffer` | 把 groff 文件和 man 文档显示在 X 和 tty 上 |
| `grog` | 读取文件然后猜测使用 _`-e`_, _`-man`_, _`-me`_, _`-mm`_, _`-ms`_, _`-p`_, _`-s`_, _`-t`_ 中的哪个 `groff` 参数来打印文件。并把带有这个参数的 `groff` 命令输出到标准输出。 |
| `grolbp` | LBP-4 和 LBP-8 激光打印机系列的 `groff` 驱动 |
| `grolj4` | 产生适用于HP Laserjet4 打印机的 PCL5 格式的 `groff` 驱动 |
| `grops` | 将 GNU `troff` 的输出翻译成 PostScript |
| `grotty` | 将 GNU `troff` 的标准输出翻译成适合类打字机设备的格式 |
| `gtbl` | 指向 `tbl` 的连接 |
| `hpftodit` | 使用 `groff -Tlj4` 从一个 HP-tagged 字体文件中创建 groff 使用的字体文件。 |
| `indxbib` | 建立同 `refer`, `lookbib`, `lkbib` 一起使用的文件的文献数据库的反向列表 |
| `lkbib` | 在文献数据库中搜索包括指定关键字的条目，并将其输出到标准输出 |
| `lookbib` | 打印一个标准错误的提示，除非标准输入不是终端。从标准输入读入关键字搜索在指定文件中的文献数据库中的含有这些关键字的条目，并将结果输出到标准输出。 |
| `mmroff` | 一个简易的 `groff` 预处理器 |
| `neqn` | 将方程格式化，使其成为适应 ASCII 输出的脚本 |
| `nroff` | 这个脚本用 `nroff` 命令仿真 `groff` 命令 |
| `pfbtops` | 将 `.pfb` 格式的 Postscript 字体翻译成 ASCII 码 |
| `pic` | 将内嵌于 troff 或 TeX 输入文件中的图像编译成 `troff` 或 TeX 理解的指令 |
| `pic2graph` | 把 PIC 图表转换成反图像 |
| `post-grohtml` | 将GNU `troff` 的输出翻译成 HTML |
| `pre-grohtml` | 将GNU `troff` 的输出翻译成 HTML |
| `refer` | 将一个文件拷贝到标准输出并丢弃 _.[_ 和 _.]_ 之间作为引用的内容和在 _.R1_ 和 _.R2_ 之间解释如何处理这些引用的命令 |
| `soelim` | 读取文件将其中的 _.so 文件_ 表格替换为 _文件_ 的内容 |
| `tbl` | 将内嵌于 troff 或者 TeX 输入文件中的表格编译成 `troff` 或者 TeX 理解的指令 |
| `tfmtodit` | 建立 `groff -Tdvi` 使用的字体文件 |
| `troff` | 和 Unix 的 `troff` 高度兼容。一般运行 `groff` 来调用它，`groff` 依照合适的顺序并使用合适的参数来执行预处理程序和后处理程序。 |
';