groff - 云端在线

程序：

您的姓名

groff - groff 文档格式系统的前端

概要

groff的 [-abcegijklpstzCEGNRSUVXZ[-d cs[-D ARG[-f FAM[-F DIR[-I DIR[-K ARG]
[-L ARG[-m 姓名[-M DIR[-n NUM[-o 名单[-P ARG[-r cn[-T 开发[-w 姓名]
[-W 姓名[文件 ...]
groff的 -h | - 帮帮我
groff的 -v | - 版 [选项 ...]

商品描述

本文档描述了 groff的 程序，主要前端 groff的 文件
格式化系统。 这 groff的 程序和宏套件是一个 罗夫(7)
GNU ⟨ 自由软件集合内的系统http://www.gnu.org⟩. 这 groff的 系统有
古典的所有特征 罗夫，但增加了许多扩展。

- groff的 程序允许控制整个 groff的 系统通过命令行选项。 这
与经典案例（仅使用管道）相比，这是一个极大的简化。

配置

命令行根据通常的 GNU 约定进行解析。 之间的空白
命令行选项及其参数是可选的。 选项可以分组在一个
单个“-”（减号）。 一个文件名 - （减号）表示标准
输入。

As groff的 是一个包装程序 的troff 这两个程序共享一组选项。 但该
groff的 程序有一些额外的、原生的选项，并赋予一些新的含义 的troff
选项。 另一方面，并​​非所有 的troff 选项可以输入 groff的.

本地人 groff的 可选项
以下选项要么不存在 的troff 或被不同的解释
groff的.

-D ARG 设置使用的默认输入编码 预转换 至 ARG. 暗示 -k.

-e 预处理 方程.

-g 预处理 GRN.

-G 预处理 GRAP. 暗示 -p.

-h
- 帮帮我 打印帮助信息。

-I DIR 此选项可用于指定一个目录来搜索文件（包括
命令行和那些命名的 .psbb 和 。所以 请求，和 \X'ps： 进口' 和
\X'ps： 文件' 逃脱）。 始终首先搜索当前目录。 这
可以多次指定选项； 按顺序搜索目录
指定的。 不对使用绝对值指定的文件执行目录搜索
小路。 该选项意味着 -s 选项。

-j 预处理 化学. 暗示 -p.

-k 预处理 预转换. 这在任何其他预处理器之前运行。 请参考
至 预转换如果没有，请查看其行为的手册页 -K （或 -D) 选项被指定。

-K ARG 设置使用的输入编码 预转换 至 ARG. 暗示 -k.

-l 将输出发送到假脱机程序进行打印。 应该使用的命令
因为这是由 打印 设备描述文件中的命令，参见
格罗夫字体(5). 如果此命令不存在，则输出将通过管道传输到 LPR(1)
默认程序。 查看选项 -L 和 -X.

-L ARG 通过 ARG 到后台处理程序。 应该用一个参数传递几个参数
每个单独的 -L 选项。 注意 groff的 不会在前面加上“-”（减号）
ARG 在将其传递给假脱机程序之前。

-N 不允许换行 方程 分隔符。 这与 -N 选项
方程.

-p 预处理 图片.

-P -选项
-P -选项 -P ARG
通过 -选项 or -选项 ARG 到后处理器。 必须指定选项
带有必要的前面减号“-”或“--”，因为 groff的 才不是
在将任何破折号传递给后处理器之前，在其前面加上任何破折号。 例如，要传递一个
标题 图形编辑视图 后处理器，shell 命令

groff -X -P -title -P 'groff it' FOO

相当于

格罗夫 -X -Z FOO | gxditview -title 'groff it' -

-R 预处理 参考. 没有提供传递参数的机制 参考
因为大多数 参考 选项具有可以指定的等效语言元素
文件内。 看 参考(1) 了解更多详情。

-s 预处理 苏林.

-S 更安全的模式。 通过 -S 选项 图片 并禁用以下 的troff 要求：
。打开, .opena, .pso, .SY及 .pi. 出于安全原因，更安全的模式由
默认。

-t 预处理 表.

-T 开发 将输出设备设置为 开发. 对于这个设备， 的troff 产生 中间
产量; 看到 格罗夫输出(5). 然后 groff的 调用后处理器进行转换 的troff's
中间 产量 到其最终格式。 真实设备 groff的 旨在

dvi TeX DVI 格式（后处理器是 格罗维).

HTML
xhtml HTML 和 XHTML 输出（预处理器是 苏林 和 预grohtml,
后处理器是 后grohtml).

lbp Canon CAPSL 打印机（LBP-4 和 LBP-8 系列激光打印机；
后处理器是 格罗普).

lj4 HP LaserJet4 兼容（或其他 PCL5 兼容）打印机
（后处理器是 格罗尔吉4).

ps PostScript 输出（后处理器是 摸索).

pdf 便携式文档格式 (PDF) 输出（后处理器是 格罗夫).

对于以下 TTY 输出设备（后处理器总是 恶心), -T 选择
输出编码：

ascii 7 位 ASCII。

用于 EBCDIC 主机的 cp1047 Latin-1 字符集。

latin1 ISO 8859-1。

utf8 UTF-8 编码的 Unicode 字符集。 这种模式最
TTY 模式有用的字体，因此它是 TTY 输出的最佳模式。

以下参数选择 图形编辑视图 作为“后处理器”（它是一个
观看节目）：

X75 75dpi 分辨率，10pt 文档基础字体。

X75-12 75dpi 分辨率，12pt 文档基础字体。

X100 100dpi 分辨率，10pt 文档基础字体。

X100 12
100dpi 分辨率，12pt 文档基础字体。

默认设备是 ps.

-U 不安全模式。 恢复到（旧的）不安全行为； 见选项 -S.

-v
- 版
输出版本信息 groff的 以及由它运行的所有程序； 那
是，给定的命令行以通常的方式解析，传递 -v 所有
子程序。

-V 输出将运行的管道 groff的 （作为包装程序）在
标准输出，但不执行它。 如果多次给出，命令是
都打印在标准错误上并运行。

-X 使用 VHDL 语言编写 图形编辑视图 而不是使用通常的后处理器来（预）查看文档。
打印后台处理程序行为如选项所述 -l 和 -L 被结转到
图形编辑视图(1) 通过确定论证 -打印命令 选项
图形编辑视图(1). 这设置了默认值 打印 操作和相应的菜单项
到那个值。 -X 只产生好的结果 -Tps, -TX75, -TX75-12, -TX100,
和 -TX100-12. 预览的默认分辨率 -Tps 输出为 75dpi； 这
可以通过传递改变 -解析度 选项 图形编辑视图， 例如

groff -X -P-分辨率 -P100 -man foo.1

-z 抑制产生的输出 的troff. 仅打印错误消息。

-Z 不自动后处理 groff的 中间 产量 以通常的方式。
这将导致 的troff 产量 出现在标准输出上，取代通常的
后处理器输出； 看 格罗夫输出（5）。

透明 可选项
以下选项透明地交给格式化程序 的troff 那是
打电话给 groff的 随后。 这些选项在 的troff（1）。

-a 输出的 ASCII 近似值。

-b 错误或警告回溯。

-c 禁用颜色输出。 请咨询 恶心(1) 手册页了解更多详情。

-C 启用兼容模式。

-d cs
-d 姓名=s
定义字符串。

-E 关闭 的troff 错误信息。

-f FAM 设置默认字体系列。

-F DIR 设置字体 DESC 文件的路径。

-i 在指定的输入文件之后处理标准输入。

-m 姓名
包含宏文件 姓名.tmac （或 天马行空姓名）; 也可以看看 格罗夫_tmac（5）。

-M DIR 宏文件的路径。

-n NUM 第一页编号 NUM.

-o 名单
只输出页面 名单.

-r cn
-r 姓名=n
设置号码寄存器。

-w 姓名
启用警告 姓名。 看 的troff(1) 名称。

-W 姓名
禁用警告 姓名。 看 的troff(1) 名称。

使用 格罗夫

- groff的 系统 实现经典 roff 的基础设施； 看 罗夫(7) 调查
关于如何 罗夫 系统工作一般。 由于前端程序可用
groff的 系统，使用 groff的 比 古典 罗夫. 本节给出
组成部分的概述 groff的 系统。 它补充 罗夫（7）与
groff的- 特定功能。 本节可视为文档指南
周围的 groff的 系统。

Paper 尺码
- 虚拟 使用的纸张尺寸 的troff 格式化输入是全局控制的
要求 .po, 特等及 。二。 看 格罗夫_tmac(5) 对于 'papersize' 宏包
提供方便的界面。

- 的 纸张尺寸，给出纸张的实际尺寸，受到控制
通过输出设备，如 摸索 使用命令行选项 -p 和 -l。 看 格罗夫字体(5)
以及输出设备的手册页以获取更多详细信息。 groff的 使用命令行
选项 -P 将选项传递给输出设备； 比如下面选择A4纸
在 PS 设备的横向：

groff -Tps -P-pa4 -Pl ...

前端
- groff的 程序是一个包装器 的troff(1) 程序。 它允许指定
命令行选项预处理器并自动运行后处理器
适用于所选设备。 这样做，有时繁琐的管道机制
古典 罗夫(7)可以避免。

- rog(1) 程序可用于猜对 groff的 格式化a的命令行
文件中。

- 格罗弗(1) 程序是一个全方位的查看器 groff的 文件和手册页。

预处理器
- groff的 预处理器是经典预处理器的重新实现
扩展名。 随同分发的标准预处理器 groff的 包是

方程(1) 对于数学公式，

GRN(1) 包括 小鬼(1) 图片，

图片(1) 用于绘制图表，

化学(1)
对于化学结构图，

参考(1)
对于参考书目，

苏林(1)
用于包含来自标准位置的宏文件，

和

表(1) 对于表。

经典中不可用的新预处理器 的troff is 预转换(1) 转换各种
输入编码 groff的 可以理解。 它总是在任何之前先运行
其他预处理器。

除此之外，还有一些内部预处理器会自动运行一些
设备。 这些对用户不可见。

宏
宏包可以通过选项包含 -m。 该 groff的 系统实现并扩展了所有
以兼容的方式经典宏包，并添加了一些自己的包。 实际上，
以下宏包附带 groff的:

男子 传统的手册页格式； 看 格罗夫曼(7). 它可以在
命令行为 -男子 or -m 男子.

曼多克 手册页的通用包； 它会自动识别是否
文档使用 男子 或者 doc文件 格式化并分支到相应的宏
包裹。 它可以在命令行中指定为 -曼多克 or -m 曼多克.

doc文件 BSD 风格的手册页格式； 看 groff_mdoc(7). 它可以在
命令行为 -mdoc or -m doc文件.

me 古典 me 文件格式； 看 格罗夫我(7). 它可以在
命令行为 -我 or -m me.

mm 古典 mm 文件格式； 看 格罗夫_毫米(7). 它可以在
命令行为 -毫米 or -m mm.

ms 古典 ms 文件格式； 看 格罗夫_MS(7). 它可以在
命令行为 -多发性硬化症 or -m ms.

万维网 用于包含在任意文件中的类似 HTML 的宏 groff的 文件； 看 格罗夫_www（7）。

有关宏文件命名及其位置的详细信息，请参见 格罗夫_tmac（5）;
该手册页还记录了其他一些未提及的次要辅助宏包
点击此处。

代码编程 语言
通用的通用概念 罗夫 编程语言在 罗夫（7）。

- groff的 对经典的扩展 的troff 语言记录在 groff_diff（7）。

- groff的 语言作为一个整体被描述在（仍然不完整） groff的 info 文件，一个
简短（但完整）的参考可以在 groff的（7）。

格式化程序
中央 罗夫 内的格式化程序 groff的 系统 的troff(1). 它提供了功能
无论是古典 的troff 和 恩罗夫，以及 groff的 扩展名。 命令行
选项 -C 开关 的troff 成 兼容性 模式 它试图模仿古典 罗夫 as
尽可能地。

有一个shell脚本 恩罗夫(1) 模仿经典行为 恩罗夫. 它尝试
根据当前区域设置自动选择正确的输出编码。

格式化程序生成 中间 产量; 看到 格罗夫输出（7）。

设备
In 罗夫，输出目标被称为 设备. 一个设备可以是一个硬件，
例如，打印机或软件文件格式。 设备由选项指定 -T。 该
groff的 设备如下。

ASCII 使用文本输出 ASCII(7) 字符集。

cp1047 使用 EBCDIC 代码页 IBM cp1047（例如，OS/390 Unix）的文本输出。

DVI TeX DVI 格式。

HTML HTML 输出。

latin1 使用 ISO Latin-1 (ISO 8859-1) 字符集的文本输出； 看 iso_8859_1（7）。

磅 佳能 CAPSL 打印机（LBP-4 和 LBP-8 系列激光打印机）的输出。

lj4 HP LaserJet4 兼容（或其他 PCL5 兼容）打印机。

ps PostScript 输出； 适用于打印机和预览器，例如 gv（1）。

PDF格式 PDF文件； 适合使用工具查看，例如 表明（1）和 秋葵（1）。

utf8 使用 Unicode (ISO 10646) 字符集和 UTF-8 编码的文本输出； 看
统一（7）。

的xhtml XHTML 输出。

X75 75dpi X Window System 输出适合预览者 视图（1x）和
图形编辑视图(1). 12pt 文档基础字体的变体是 X75 12.

X100 100dpi X Window System 输出适合预览者 视图（1x）和
图形编辑视图(1). 12pt 文档基础字体的变体是 X100 12.

用于设备的后处理器由 后期制作 在命令
设备描述文件； 看 格罗夫字体(5). 这可以被覆盖 -X 选项。

默认设备是 ps.

后处理器
groff的 提供3个硬件后处理器：

格罗普(1)
对于某些佳能打印机，

格罗尔吉4(1)
适用于与 HP LaserJet 4 和 PCL5 兼容的打印机，

恶心(1)
用于使用各种编码的文本输出，例如，在面向文本的终端或 line-
打印机。

今天，大多数打印或绘图硬件由操作系统处理，按设备
驱动程序，或通过软件接口，通常接受 PostScript。 因此，有
对更多硬件设备后处理器的需求并不迫切。

- groff的 用于转换为其他文档文件格式的软件设备是

格罗维(1)
对于 DVI 格式，

格罗姆特(1)
对于 HTML 和 XHTML 格式，

摸索(1)
对于 PostScript。

格罗夫(1)
为PDF。

结合许多现有的免费转换工具，这应该足以转换
a 的troff 文档转换成几乎任何现有的数据格式。

Utilities / 效用
以下实用程序围绕 groff的 是可用的。

添加信息(1)
添加信息到 的troff 字体描述文件用于 groff的.

修改(1)
为 PostScript 设备创建字体描述文件。

方程2图(1)
转换一个 方程 图像转换为裁剪图像。

gdiffmk(1)
标记之间的差异 groff的, 恩罗夫或 的troff 文件。

图形(1)
转换一个 GRAP 将图表转换为裁剪的位图图像。

格罗弗(1)
通用查看器程序 groff的 文件和手册页。

图形编辑视图(1)
- groff的 X 查看器，GNU 版本 视图.

编辑(1)
为 lj4 设备创建字体描述文件。

索引(1)
为书目数据库制作倒排索引。

书包(1)
搜索书目数据库。

围兜(1)
交互式搜索书目数据库。

pdfroff(1)
使用创建 PDF 文档 groff的.

聚苯硫醚(1)
将 .pfb 格式的 PostScript 字体转换为 ASCII。

图二图(1)
转换一个 图片 将图表转换为裁剪后的图像。

tfmto编辑器(1)
为 TeX DVI 设备创建字体描述文件。

视图（1x）
罗夫 查看器与 X 窗口一起分发。

托特罗夫(1)
将 X 字体度量转换为 GNU 的troff 字体指标。

环境

通常，以下环境变量中的路径分隔符是冒号； 这可能
因操作系统而异。 例如，DOS 和 Windows 使用分号
代替。

GROFF_BIN_PATH
这个搜索路径，后面跟着 $路径, 用于执行的命令
groff的. 如果未设置，则该目录所在的目录 groff的 安装了二进制文件
前置于 PATH.

GROFF_COMMAND_PREFIX
当需要运行不同的 罗夫 同时实施 groff的
提供了为大多数程序添加前缀的工具，这些程序可以
在运行时引发名称冲突（默认是没有）。 从历史上看，这
前缀是字符 g，但它可以是任何东西。 例如， 格特罗夫 代表
groff的's 的troff, GTBL 等加工。为 groff的 版本的 表. 通过设置 GROFF_COMMAND_PREFIX
不同的价值观，不同的 罗夫 可以解决安装问题。 更多的
确切地说，如果它设置为前缀 XXX 然后 groff的 作为内部包装程序
电话 XXX的troff 而不是 的troff. 这也适用于预处理器 方程, GRN,
图片, 参考, 表, 苏林, 和公用事业 索引 和 围兜. 此功能
不适用于与上述程序不同的任何程序（最显着的是 groff的
本身）因为它们是独一无二的 groff的 包。

GROFF_ENCODING
这个环境值的值被传递给 预转换 要选择的预处理器
输入文件的编码。 设置此选项意味着 groff的的命令行
选项 -k （这是， groff的 实际上总是打电话 预转换）。 如果没有设置值，
groff的 电话 预转换 没有论据。 一个明确的 -K 命令行选项
覆盖的值 GROFF_ENCODING。 看 预转换(1) 详情。

GROFF_FONT_PATH
在其中搜索的目录列表 开发姓名 除了目录
默认的。 看 的troff（1）和 格罗夫字体(5) 了解更多详情。

GROFF_TMAC_PATH
除了默认目录之外，还可以在其中搜索宏文件的目录列表
目录。 看 的troff（1）和 格罗夫_tmac(5) 了解更多详情。

GROFF_TMPDIR
创建临时文件的目录。 如果没有设置，但是
环境变量 TMPDIR 相反，在目录中创建临时文件
$ TMPDIR. 在 MS-DOS 和 Windows 32 平台上，环境变量 TMP 和
TEMP （按该顺序）也被搜索，之后 GROFF_TMPDIR 和 TMPDIR。 除此以外，
临时文件在 / tmp目录。 该 参考（1） 格罗弗（1） 格罗姆特（1），
摸索(1) 命令使用临时文件。

GROFF_TYPESETTER
预设默认设备。 如果没有设置 ps 设备作为默认使用。
此设备名称被选项覆盖 -T.

示例

下面的例子说明了 groff的 程序作为包装器
的troff.

处理一个 罗夫 使用预处理器的文件 表 和 图片 和 me 宏集，古典
的troff 必须由

图片 foo.me | 表 | troff -me -Tlatin1 | 恶心

运用 groff的, 这个管道可以缩短为等效的命令

groff -p -t -me -T latin1 foo.me

调用它的更简单的方法是使用 rog(1)猜测预处理器和宏
options 并执行生成的命令（通过使用反引号指定 shell 命令
替代）

`grog -Tlatin1 foo.me`

最简单的方法是通过调用以自动方式查看内容

groffer foo.me

使用 onworks.net 服务在线使用 groff