Manpages

NAME

troff - groff 文 档 排 版 系 统 的 troff 处 理 器

总 览 SYNOPSIS

troff-abcivzCERU ] [ -dcs ] [ -ffam ] [ -Fdir ] [ -mname ] [ -Mdir ] [ -nnum ] [ -olist ] [ -rcn ] [ -Tname ] [ -wname ] [ -Wname ] [ files... ] 在 一 个 命 令 行 选 项 与 其 参 数 之 间 可 以 有 空 格 。

描 述 DESCRIPTION

这 份 手 册 页 描 述 了 GNU 版 本 的 troff. 它 是 groff 文 档 排 版 系 统 的 一 部 分 。 它 与 UNIX troff 的 功 能 兼 容 , 但 是 有 很 多 的 扩 展 , 参 见 groff_diff(7). 通 常 它 应 当 用 groff(1) 命 令 调 用 , groff 会 以 合 适 的 顺 序 和 合 适 的 选 项 , 运 行 预 处 理 器 和 后 处 理 器 。

选 项 OPTIONS

-a 产 生 一 个 排 版 输 出 的

ASCII 近 似 结 果 (approximation)

-b 在 每 条 错 误 或 警 告 消 息

中 打 印 回 溯 信 息 此 信 息 可 以 帮 助 跟 踪 错 误 的 原 因 信 息 中 的 行 号 可 能 有 误 , 因 为 troff 中 行 号 的 意 义 与 请 求 类 型 是 as 还 是 am 有 关

-c

禁 止 颜 色 输 出 (兼 容 模 式 下 总 是 禁 止 )
-C
使 用 兼 容 模 式
-d
cs
-d
name=s 定 义

cname 是 一 个 字 符 串 s; c 必 须 是 单 字 符 的 一 个 名 称

-E 阻 止

troff 的 错 误 输 出 . 注 意 这 不 影 响 发 出 tmtm1 请 求 的 宏 包

发 出 的 错 误 消 息 向 标 准 错 误 输 出

-ffam 使 用

fam 作 为 默 认 字 体 族

-Fdir 在 目 录

中 (或 目 录 路 径 中 ) 搜 索 dir 子 目 录 devname (name 是 设 备 的 名 称 ) 查 找 其 中 的 DESC 文 件 和 字 体 文 件 dir 在 所 有 其 他 字 体 目 录 之 前 查 找
-i

处 理 完 所 有 输 入 文 件 后 继 续 从 标 准 输 入 读 入

-mname 读 入 文 件

name.tmac. 如 果 没 有 找 到 , 则 去 读 tmac.name 它 将 先 在

-M 命 令 行 参 数 给 定 的 目 录 中 搜 索 , 然 后 是 GROFF_TMAC_PATH 环 境 变 量 中 的 目 录 , 然 后 是 当 前 目 录 (安 全 模 式 不 会 做 这 一 步 ), 然 后 是 个 人 目 录 , /usr/lib/groff/site-tmac, /usr/share/groff/site-tmac 还 有 /usr/share/groff/1.18.1/tmac.

-Mdir 搜 索 目 录

(或 目 录 路 径 ) dir 查 找 宏 文 件 检 索 在 所 有 其 他 宏 目 录 之 前

进 行

-nnum 为 第 一 页 编 号

num.

-olist 仅 输 出

list 中 指 定 的 页 , 参 数 是 一 个 以 逗 号 分 隔 的 页 号 范 围 的 列 表 ; n 意 思 是 打 印 页 面 n, m-n 意 思 是 打 印 mn 之 间 的 所 有 页 面 , -n 意 思 是 打 印 直 到 n 的 所 有 页 面 , n- 意 思 是 打 印 从 n 开 始 的 所 有 页 面 , 直 到 结 束 . troff 打 印 完 列 表 中 的 最 后 一 页 后 将 退 出

-rcn

-rname=n 设 置 数 字 寄 存 器

cnamen; c 必 须 是 单 字 符 的 一 个 名 称 , n

可 以 是 任 何 troff 数 字 表 达 式

-R 不 读 取

troffrctroffrc-end.

-Tname 为 设 备

name 而 不 是 默 认 的 ps 准 备 输 出

-U 不 全 模 式

这 将 允 许 下 列 请 求 open, opena, pso, sy, 和 pi. 出 于 安 全 原 因 , 这 些 潜 在 的 危 险 的 请 求 在 其 他 情 况 下 被 禁 止 。 同 时 它 将 当 前 目 录 加 入 宏 搜 索 路 径
-v

打 印 版 本 号

-wname 允 许 发 出

name 警 告 。 可 能 的 警 告 名 称 在 下 面 的 警 告 WARNINGS 章 节

中 详 述 例 如 , 要 允 许 所 有 警 告 , 使 用 -w all. 允 许 使 用 多 个 -w 选 项

-Wname 禁 止 发 出

name 警 告 。 允 许 使 用 多 个 -W 选 项

-z 阻 止 格 式 化

的 输 出

警 告 WARNINGS

troff 可 以 发 出 的 警 告 分 为 下 列 类 别 每 种 警 告 关 联 的 名 称 在 -w-W 选 项 中 使 用 ; 关 联 的 数 字 被 warn 请 求 和 .warn 寄 存 器 使 用 , 它 总 是 2 的 幂 , 以 允 许 位 运 算

break 4 在 填 充

(fill) 模 式 下 , 不 可 分 行 的 行 的 长 度 比 行 的 长 度

要 小 。 In fill mode, lines which could not be broken so that their length was less than the line length. 此 警 告 是 默 认 允 许 的

char 1 不 存 在 的 字 符 。 此 警 告 是 默 认 允 许 的

color 524288 颜 色 相 关 的 警 告

delim 8 关 闭 定 界 符 丢 失 或 不 匹 配

di 256 没 有 当 前 转 移

(current diversion) 而 使 用 了 不 带 参 数 的 dida

el 16 使 用

el 请 求 但 是 没 有 相 应 的 ie 请 求

escape 32768 不 可 识

别 的 转 义 序 列 。 当 遇 到 一 个 不 可 识 别 的 转 义 序 列 时 , 转 义 字 符 被 忽 略

font 131072 不 存 在 的 字 体 。 此 警 告 是 默 认 允 许 的

ig 262144

ig 请 求 忽 略 的 文 本 中 的 非 法 转 义 。 如 果 不 是 在 被 忽 略 的 文 本 中 , 它 们 将 是 错 误

input 16384 非 法 输 入 字 符

mac 512 使 用 未 定 义 的 字 符 串 , 宏 和 标 号

(diversions) (?). 当

使 用 一 个 未 定 义 的 字 符 串 , 宏 或 标 号 (diversions) 时 , 字 符 串 被 自 动 定 义 为 空 。 因 此 , 在 大 多 数 情 况 下 , 每 个 名 字 最 多 会 给 出 一 个 警 告

missing 8192 请 求 缺 少 必 要 的 参 数

number 2 非 法 数 值 表 达 式 。 此 警 告 是 默 认 允 许 的

range 64 超 出 范 围 的 参 数

reg 1024 使 用 未 定 义 的 数 字 寄 存 器 。 当 使 用 一 个 未 定 义 的 数 字 寄 存 器 时 , 寄 存 器 被 自 动 定 义 为 值  

0。 因 此 , 大 多 数 情 况 下 , 使 用 一 个 特 定 的 名 字 最 多 会 得 到 一 个 警 告

right-brace 4096 在 应 当 使 用 数 字 的 地 方 使 用 了

\}

scale 32 无 意 义 的 比 例 指 示

(scaling indicators).

space 65536 在 一 个 请 求 或 宏 与 其 参 数 之 间 缺 少 空 格 。 当 遇 到 一 个 两 个 字 符 以 上 的 未 定 义 名 字 , 并 且 名 字 的 前 两 个 字 符 是 一 个 已 定 义 的 名 称 时 将 给 出 这 个 警 告 , 请 求 或 宏 不 会 执 行 。 当 给 出 这 个 警 告 时 , 不 会 自 动 定 义 宏 。 此 警 告 是 默 认 允 许 的 。 在 兼 容 模 式 下 不 会 发 生 这 种 警 告

syntax 128 数 值 表 达 式 中 语 法 有 歧 义

tab 2048 不 合 适 地 使 用 了

tab 字 符 。 在 应 当 使 用 数 字 的 地 方 使 用 了 tab字 符 , 或 者 在 一 个 未 用 双 引 号 引 用 的 宏 参 数 中 使 用 tab 时 会 发 生 也 有 可 以 引 用 一 组 警 告 的 名 称

all 所 有 的 警 告 , 除 了

di, mac, 和 reg. 它 的 目 的 是 指 代 所 有 在 传 统 的 宏

包 中 有 用 的 警 告

w 所 有 警 告

环 境 ENVIRONMENT

GROFF_TMAC_PATH 一 个 以 冒 号 分 隔 的 目 录 的 列 表 , 从 中 搜 索 宏 文 件 troff 将 先 搜 索 -M 选 项 给 出 的 目 录 , 以 及 标 准 的 路 径 ( 当 前 目 录 (如 果 是 不 安 全 模 式 ), 个 人 目 录 /usr/lib/groff/site-tmac, /usr/share/groff/site-tmac, /usr/share/groff/1.18.1/tmac) 最 后 搜 索 它
GROFF_TYPESETTER
默 认 设 备
GROFF_FONT_PATH
一 个 以 冒 号 分 隔 的 目 录 的 列 表 , 从 中 搜 索 devname 目 录 。 troff 将 先 搜 索 -F 选 项 给 出 的 目 录 , 以 及 标 准 的 路 径 (/usr/share/groff/site-font, /usr/share/groff/1.18.1/font, /usr/lib/font) 最 后 搜 索 它

文 件 FILES

/usr/share/groff/1.18.1/tmac/troffrc 初 始 化 文 件 (在 任 何 其 他 宏 包 之 前 调 用 ).
/usr/share/groff/1.18.1/tmac/troffrc-end
初 始 化 文 件 (在 任 何 其 他 宏 包 之 后 调 用 ).
/usr/share/groff/1.18.1/tmac/
name.tmac
/usr/share/groff/1.18.1/tmac/tmac.
name 宏 文 件
/usr/share/groff/1.18.1/font/dev
name/DESC 设 备 name 的 设 备 描 述 文 件 .
/usr/share/groff/1.18.1/font/dev
name/F 设 备 name 的 字 体 F 的 字 体 文 件 注 意 默 认 情 况 下 既 不 在 当 前 目 录 也 不 在 个 人 目 录 搜 索 troffrctroffrc-end , 因 为 安 全 的 原 因 (即 使 给 出 了 -U 选 项 )。 如 果 有 必 要 , 使 用 -M 命 令 行 选 项 或 者 GROFF_TMAC_PATH 环 境 变 量 来 将 这 些 路 径 添 加 到 搜 索 路 径 中

作 者 AUTHOR

Copyright (C) 1989, 2001, 2002 Free Software Foundation, Inc. 此 文 档 按 照 FDL (GNU Free Documentation License) 1.1 或 更 新 版 本 的 要 求 发 布 。 You should have received a copy of the FDL on your system, it is also available on-line at the http://www.gnu.org/copyleft/fdl.html">GNU copyleft site. This document was written by James Clark, with modifications from wl [AT] gnu.org">Werner Lemberg 和 bwarken [AT] mayn.de">Bernd Warken 此 文 档 是 groff GNU roff 套 件 的 一 部 分

参 见 SEE ALSO

groff(1)

groff 系 统 的 主 程 序 , troff 的 包 装 .

groff(7)

groff 语 言 的 描 述 , 包 括 一 个 虽 然 短 但 是 完 整 的 手 册 , 内 容 是 所 有 预 定 义 的 请 求 (request), 寄 存 器 (register) 和 groff 正 文 的 转 义 (escapes of plain groff). 可 以 在 命 令 行 查 看 , 使 用 命 令

man 7 groff

groff_diff(7)

groff 语 言 和 传 统 的 classical troff 语 言 不 同 之 处 。 当 前 , 这 是 groff 系 统 最 为 现 实 (actual) 的 一 篇 文 档

roff(7)groff 和 其 他 roff 系 统 的 概 述 , 包 括 更 多 相 关 文 档 的 链 接

groff info file, 参 见 (cf.) info(1), 将 所 有 groff 文 档 整 合 到 了 单 独 的 一 篇 文 档 中

[中 文 版 维 护 人 ]

bbbush <bbbush [AT] 163.com>

[中 文 版 最 新 更 新 ]

2003.11.25

《 中 国 linux论 坛 man手 册 翻 译 计 划 》 :

http://cmpp.linuxforum.net

本 页 面 中 文 版 由 中 文 man 手 册 页 计 划 提 供 。 中 文 man 手 册 页 计 划 : https://github.com/man-pages-zh/manpages-zh