Man page - troff(1)

Packages contains this manual

Available languages:

en ja zh_TW zh_CN

Manual

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 的 幂 , 以 允 许 位 运 算

Image grohtml-1186207-1.png

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