Man page - troff(1)
Packages contains this manual
Available languages:
en ja zh_TW zh_CNManual
TROFF
NAME总 览 SYNOPSIS
描 述 DESCRIPTION
选 项 OPTIONS
警 告 WARNINGS
环 境 ENVIRONMENT
文 件 FILES
作 者 AUTHOR
参 见 SEE ALSO
[中 文 版 维 护 人 ]
[中 文 版 最 新 更 新 ]
《 中 国 linux论 坛 man手 册 翻 译 计 划 》 :
跋
NAME
troff - groff 文 档 排 版 系 统 的 troff 处 理 器
总 览 SYNOPSIS
troff [ -abcivzCERU ] [ -d cs ] [ -f fam ] [ -F dir ] [ -m name ] [ -M dir ] [ -n num ] [ -o list ] [ -r cn ] [ -T name ] [ -w name ] [ -W name ] [ 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 |
定 义 c 或 name 是 一 个 字 符 串 s ; c 必 须 是 单 字 符 的 一 个 名 称 |
||
|
-E |
阻 止 troff 的 错 误 输 出 . 注 意 这 不 影 响 发 出 tm 或 tm1 请 求 的 宏 包 发 出 的 错 误 消 息 向 标 准 错 误 输 出 |
||
|
-f fam |
使 用 fam 作 为 默 认 字 体 族 |
||
|
-F dir |
在 目 录 中 (或 目 录 路 径 中 ) 搜 索 dir 子 目 录 dev name ( name 是 设 备 的 名 称 ) 查 找 其 中 的 DESC 文 件 和 字 体 文 件 dir 在 所 有 其 他 字 体 目 录 之 前 查 找 |
||
|
-i |
处 理 完 所 有 输 入 文 件 后 继 续 从 标 准 输 入 读 入 |
||
|
-m name |
读 入 文 件 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. |
||
|
-M dir |
搜 索 目 录 (或 目 录 路 径 ) dir 查 找 宏 文 件 检 索 在 所 有 其 他 宏 目 录 之 前 进 行 |
||
|
-n num |
为 第 一 页 编 号 num . |
||
|
-o list |
仅 输 出 list 中 指 定 的 页 , 参 数 是 一 个 以 逗 号 分 隔 的 页 号 范 围 的 列 表 ; n 意 思 是 打 印 页 面 n , m - n 意 思 是 打 印 m 到 n 之 间 的 所 有 页 面 , - n 意 思 是 打 印 直 到 n 的 所 有 页 面 , n - 意 思 是 打 印 从 n 开 始 的 所 有 页 面 , 直 到 结 束 . troff 打 印 完 列 表 中 的 最 后 一 页 后 将 退 出 |
||
|
-r cn |
|||
|
-r name = n |
设 置 数 字 寄 存 器 c 或 name 为 n ; c 必 须 是 单 字 符 的 一 个 名 称 , n 可 以 是 任 何 troff 数 字 表 达 式 |
||
|
-R |
不 读 取 troffrc 和 troffrc-end . |
||
|
-T name |
为 设 备 name 而 不 是 默 认 的 ps 准 备 输 出 |
||
|
-U |
不 全 模 式 这 将 允 许 下 列 请 求 open , opena , pso , sy , 和 pi . 出 于 安 全 原 因 , 这 些 潜 在 的 危 险 的 请 求 在 其 他 情 况 下 被 禁 止 。 同 时 它 将 当 前 目 录 加 入 宏 搜 索 路 径 |
||
|
-v |
打 印 版 本 号 |
||
|
-w name |
允 许 发 出 name 警 告 。 可 能 的 警 告 名 称 在 下 面 的 警 告 WARNINGS 章 节 中 详 述 例 如 , 要 允 许 所 有 警 告 , 使 用 -w all . 允 许 使 用 多 个 -w 选 项 |
||
|
-W name |
禁 止 发 出 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) 而 使 用 了 不 带 参 数 的 di 或 da |
||
|
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
一 个 以 冒 号 分 隔 的 目 录 的 列 表 , 从 中 搜 索 dev name 目 录 。 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 的 字 体 文 件
注 意 默 认 情 况 下 既 不 在 当 前 目 录 也 不 在 个 人 目 录 搜 索 troffrc 和 troffrc-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 GNU copyleft site . This document was written by James Clark, with modifications from Werner Lemberg 和 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@163.com>
[中 文 版 最 新 更 新 ]
2003.11.25
《 中 国 linux论 坛 man手 册 翻 译 计 划 》 :
http://cmpp.linuxforum.net
跋
本
页 面 中 文 版 由
中 文 man 手 册 页 计
划 提 供 。
中 文 man 手 册 页 计
划 :
https://github.com/man-pages-zh/manpages-zh