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

COMMENTS