Manpages

NAME

roff - roff 排 版 系 統 的 概 念 和 歷 史

描 述 DESCRIPTION

roff 是 一 系 列 排 版 程 序 , 如 troff, nroff, ditroff, groff, 等 等 的 通 稱 。 一 個 roff 排 版 系 統 包 含 一 個 可 擴 展 的 文 本 格 式 化 語 言 和 一 系 列 程 序 用 以 打 印 和 轉 換 爲 其 他 文 本 格 式 。 傳 統 的 , 它 是 Unix 的 主 要 文 本 處 理 系 統 ; 現 在 , 每 個 類 Unix 操 作 系 統 仍 然 附 帶 一 個 roff 系 統 作 爲 核 心 軟 件 包 。 當 今 最 普 遍 的 roff 系 統 是 自 由 軟 件 的 實 現 GNU roff, groff(1). groff 之 前 的 實 現 被 稱 爲 傳 統 的 classical 實 現 (從 1973 年 開 始 )。 groff 實 現 了 它 的 傳 統 的 前 輩 的 用 法 和 功 能 , 並 且 加 入 了 更 多 擴 展 。 當 前 , 由 於 groff 是 唯 一 可 以 在 (幾 乎 是 ) 任 何 計 算 機 系 統 上 都 可 用 的 roff 系 統 , 因 此 它 是 事 實 上 的 roff 標 準 。 在 一 些 古 老 的 Unix 系 統 中 , 有 一 個 叫 做 roff 的 可 執 行 文 件 , 實 現 了 甚 至 更 加 古 老 的 Multics 操 作 系 統 中 的 runoff 。 參 見 HISTORY 段 落 。 它 的 功 能 非 常 有 限 , 即 使 與 古 老 的 troff 相 比 ; 它 不 再 被 支 持 了 。 因 此 , 在 本 文 檔 中 , roff 總 是 泛 指 roff 系 統 roff system , 不 是 古 老 的 roff 可 執 行 文 件 儘 管 歷 史 悠 久 , roff 當 前 還 在 廣 泛 使 用 中 , 例 如 , UNIX 系 統 的 手 冊 頁 (man pages) , 很 多 軟 件 書 籍 , 系 統 文 檔 , 標 準 和 團 體 組 織 的 文 檔 都 是 用 roff 來 寫 的 。 roff 在 文 本 設 備 上 的 輸 出 效 果 仍 然 是 無 可 比 擬 的 , 並 且 , 與 其 他 自 由 的 排 版 系 統 相 比 , 它 的 圖 形 輸 出 也 不 差 , 甚 至 強 於 很 多 商 業 的 系 統 最 普 遍 的 roff 的 應 用 是 手 冊 頁 manual pages (簡 稱 man pages); 它 是 很 多 操 作 系 統 中 的 標 準 文 檔 系 統 此 文 檔 描 述 了 圍 繞 roff system 開 發 的 一 些 歷 史 事 件 ; 所 有 roff 版 本 在 用 法 方 面 的 一 些 共 同 點 , roff 管 道 的 細 節 - - 它 經 常 被 掩 蓋 在 類 似 groff(1) 等 等 的 “前 端 ” 之 後 ; 對 排 版 語 言 的 一 般 的 概 述 ; 一 些 寫 roff 文 檔 的 技 巧 ; 還 有 到 更 多 資 料 的 鏈 接

歷 史 HISTORY

roff 文 本 處 理 系 統 有 很 長 的 一 段 歷 史 , 可 以 回 溯 到 60 年 代 。 roff 系 統 自 身 與 Unix 操 作 系 統 關 係 密 切 , 但 是 它 的 起 源 要 從 更 早 的 操 作 系 統 CTSS 和 Multics 開 始 。 祖 先 The Predecessor runoff
roff
系 統 的 演 變 與 操 作 系 統 的 歷 史 緊 密 聯 繫 。 它 的 “先 祖 ” runoffJerry SaltzerCTSS 操 作 系 統 (Compatible Time Sharing System , 兼 容 分 時 系 統 (?), 1961) 上 的 作 品 。 CTTS 後 來 發 展 成 爲 操 作 系 統 http://www.multicians.org">Multics, Unix 的 一 個 著 名 的 來 源 , 出 現 於 1963, 同 時 runoff 成 爲 文 檔 和 文 本 處 理 的 主 要 格 式 。 當 時 , 這 兩 種 操 作 系 統 只 能 運 行 在 非 常 昂 貴 的 計 算 機 之 上 , 因 此 它 們 大 部 分 用 於 研 究 和 官 方 及 軍 隊 的 任 務 之 中 與 現 代 的 roff 相 比 , runoff 語 言 可 以 做 的 事 非 常 有 限 。 在 60 年 代 , 只 能 產 生 文 本 的 輸 出 。 這 可 以 用 一 個 長 度 爲  2 的 命 令 (request) 的 集 合 實 現 , 這 些 命 令 的 絕 大 部 分 都 保 持 不 變 地 被 roff 採 用 。 這 種 語 言 的 模 型 是 根 據 “前 計 算 機 時 代 ” 的 排 版 習 慣 而 建 立 的 , 那 時 , 以 點 (dot, ’.’) 開 頭 的 行 被 寫 在 手 稿 中 , 向 之 後 進 行 手 工 排 版 工 作 的 工 人 指 示 格 式 化 的 要 求 開 始 , runoff 程 序 是 用 PL/1 語 言 寫 成 的 , 後 來 用 BCPL 來 寫 - - 那 是 編 程 語 言 的 “祖 母 ”。 在 Multics 操 作 系 統 中 , 幫 助 系 統 由 runoff 來 處 理 , 與 roff 管 理 Unix 手 冊 頁 的 作 用 類 似 。 仍 然 有 runoff 語 言 寫 成 的 文 檔 , 例 如 可 以 到 Saltzer 的 主 頁 看 看 。 參 見 SEE ALSO傳 統 的 nroff/troff 系 統 The Classical nroff/troff System 在 70 年 代 , Multics 的 後 裔 (offspring) Unix 變 得 越 來 越 普 遍 , 因 爲 它 可 以 運 行 在 廉 價 的 計 算 機 上 , 並 且 那 時 在 大 學 裏 可 以 很 容 易 地 獲 得 。 在 MIT (麻 省 理 工 , the Massachusetts Institute of Technology), 有 人 想 在 一 臺 運 行 Unix 的 PDP-11 計 算 機 上 驅 動 Wang (王 安 公 司 ?) 的 Graphic Systems CAT 排 字 機 , 一 種 圖 形 化 的 輸 出 設 備 。 由 於 runoff 在 這 種 任 務 上 能 力 有 限 , 它 被 Josef F. Osanna, (Multics 操 作 系 統 的 主 要 開 發 者 之 一 , 幾 個 runoff 移 植 系 統 的 作 者 ) 繼 續 開 發 , 成 爲 一 種 更 強 大 的 文 本 排 版 系 統

runoff 這 個 名 字 被 簡 化 爲 roff. Ocsanna 所 設 想 的 , 極 大 擴 展 了 的 語 言 已 經 包 含 了 一 個 完 整 的 roff 系 統 的 所 有 元 素 。 所 有 現 代 的 roff 系 統 都 試 圖 實 現 同 這 個 系 統 兼 容 。 因 此 Joe Osanna 是 當 之 無 愧 的 所 有 roff 系 統 之 父 最 早 的 roff 系 統 有 三 個 排 版 程 序

troff

(typesetter roff) 爲 它 唯 一 支 持 的 CAT 排 字 機 產 生 一 個 圖 形 的 輸 出

nroff

爲 終 端 和 文 本 打 印 機 產 生 合 適 的 文 本 輸 出

roff 對 最 初 的

runoff 程 序 的 有 限 功 能 進 行 重 新 實 現 ; 這 個 程 序 在 後 來 的 版

本 中 被 拋 棄 。 現 在 , roff 這 個 名 字 只 用 來 指 代 一 個 troff/nroff 系 統 的 整 體

Osanna 的 第 一 版 用 PDP-11 的 彙 編 語 言 實 現 , 發 佈 於 1973. Brian Kernighan 加 入 到 roff 的 開 發 中 , 使 用 C 編 程 語 言 將 它 進 行 了 重 寫 。 C 版 本 發 佈 於 1975.

nroff/troff 程 序 使 用 的 排 版 語 言 的 語 法 記 載 在 著 名 的 Troff User’s Manual [CSTR #54] 中 , 出 版 於 1976, Brian Kernighan 對 它 不 斷 修 訂 , 直 到 1992 年 。 此 文 檔 是 對 傳 統 的 classical troff 的 說 明 . 所 有 後 來 的 roff 系 統 都 試 着 與 這 個 說 明 實 現 兼 容

1977 年 , Osanna 在 他  50 歲 時 , 由 於 一 次 突 發 的 心 臟 病 而 去 世 。 Kernighan 繼 續 開 發 troff。 下 一 個 開 發 目 標 是 賦 予 troff 一 個 更 一 般 的 接 口 , 以 支 持 更 多 設 備 , 中 間 輸 出 格 式 和 “後 處 理 ” 系 統 。 這 使 得 roff 系 統 的 結 構 趨 於 完 整 , 現 在 仍 然 被 使 用 。 參 見 USING ROFF 段 。 1979 年 , 它 們 被 寫 入 論 文 [CSTR #97]. 這 個 新 的 troff 版 本 是 所 有 現 存 的 較 新 的 troff 系 統 的 基 礎 , 包 括 groff. 在 一 些 系 統 上 , 這 個 設 備 無 關 的 troff 有 一 個 可 執 行 文 件 叫 做 ditroff(7). 所 有 現 代 的 troff 程 序 都 已 經 自 動 提 供 了 對 distroff 完 整 的 兼 容 性 商 業 化 Commercialization 免 費 的 Unix 7 操 作 系 統 商 業 化 之 後 , 出 現 了 嚴 重 的 退 步 。 一 大 批 不 同 的 操 作 系 統 浮 出 水 面 , 爲 他 們 所 作 的 擴 展 間 的 互 不 兼 容 而 爭 鬥 。 幸 好 , 這 種 不 兼 容 沒 有 影 響 到 原 始 的 troff。 所 有 不 同 的 商 業 版 本 的 roff 系 統 都 大 量 使 用 了 Osanna/ Kernighan 的 開 放 的 源 代 碼 和 文 檔 , 但 是 卻 將 其 作 爲 它 們 的 系 統 (“their” system) 出 售 — 只 有 很 少 的 修 改 古 老 的 Unix 和 傳 統 的 troff 的 源 代 碼 在 長 達 20 年 時 間 裏 不 再 可 以 自 由 獲 得 。 幸 運 的 是 , Caldera 收 購 了 SCO UNIX (2001). 隨 後 , Caldera 使 得 源 代 碼 可 以 在 網 上 獲 得 , 允 許 用 於 非 商 業 用 途 。 參 見 SEE ALSO

(譯 註 : 誰 能 想 到 , 現 在 , 2003 年 , SCO會 成 爲 自 由 軟 件 和 開 源 軟 件 界 共 同 的 敵 人 呢 ? 而 Caldera 又 在 什 麼 地 方 呢 ? ) 自 由 的 Free roff 任 何 商 業 的 roff 系 統 都 無 法 成 爲 roff 開 發 中 的 後 繼 者 。 商 業 社 會 中 的 每 個 人 都 只 對 他 們 自 己 的 事 情 感 興 趣 。 這 使 得 曾 經 如 此 優 秀 的 Unix 操 作 系 統 在 80 年 代 一 蹶 不 振 作 爲 對 如 此 快 速 的 商 業 化 過 程 的 補 救 (As a counter-measure to the galopping commercialization, 還 請 重 新 翻 譯 ), AT&T Bell Labs 貝 爾 實 驗 室 試 圖 發 起 一 個 恢 復 性 的 項 目 (? , a rescue project) , 使 用 他 們 的 Plan 9 操 作 系 統 。 它 可 以 免 費 用 於 非 商 業 用 途 , 甚 至 包 含 了 源 代 碼 。 但 是 它 有 一 個 專 利 許 可 證 , that empedes the free development ( 還 請 解 釋 詞 義 )。 這 種 想 法 早 已 過 時 , 因 此 Plan 9 沒 有 被 主 流 開 發 者 接 受 爲 自 己 的 平 臺 真 正 的 補 救 措 施 (? , remedy) 是 不 斷 出 現 的 自 由 操 作 系 統 (386BSD, GNU/ Linux, 等 等 .) 和 80 年 代 到 90 年 代 的 自 由 軟 件 工 程 。 他 們 實 現 了 傳 統 的 Unix 的 特 性 和 很 多 擴 展 , 因 此 舊 的 “XP體 驗 ” 不 會 丟 掉 (such that the old experience is not lost)。 進 入 21 世 紀 , 類 Unix 系 統 重 新 成 爲 計 算 機 工 業 中 的 主 導 因 素 — 這 要 感 謝 自 由 軟 件 最 重 要 的 自 由 roff 計 劃 是 GNU 移 植 版 本 的 troff, 由 James Clark 建 立 , 使 用 http://www.gnu.org/copyleft">GNU Public License. 它 叫 做 groff (GNU roff). 參 見 groff(1) 中 的 概 述

groff 系 統 仍 然 在 繼 續 開 發 。 它 與 傳 統 troff 兼 容 , 但 是 還 添 加 了 很 多 擴 展 。 它 是 第 一 個 可 以 在 幾 乎 所 有 操 作 系 統 上 運 行 的 roff 系 統 並 且 — 它 是 自 由 開 放 的 。 這 使 得 groff 成 爲 現 在 roff 的 事 實 標 準

使 用 USING ROFF

很 多 人 不 會 注 意 到 他 們 在 使 用 roff。 當 你 閱 讀 一 份 手 冊 頁 (man page) 時 , roff 工 作 在 後 臺 。 roff 文 檔 可 以 使 用 xditview(1x) 程 序 查 看 , 它 是 一 個 X 發 行 版 的 標 準 程 序 。 參 見 X(7x). 但 是 顯 式 地 使 用 roff 也 不 困 難 一 些 roff 實 現 提 供 了 包 裝 程 序 , 使 得 人 們 可 以 簡 單 地 在 命 令 行 使 用 roff 系 統 。 例 如 , GNU 的 roff 實 現 groff(1) 提 供 了 命 令 行 選 項 來 避 免 傳 統 troff 中 過 長 的 的 命 令 管 道 ; grog(1) 程 序 試 着 從 文 檔 猜 測 應 當 使 用 什 麼 參 數 來 運 行 groff; 不 習 慣 於 指 定 命 令 行 選 項 的 人 應 當 用 groffer(1) 程 序 來 圖 形 化 地 顯 示 groff 文 件 和 手 冊 頁 管 道 The roff Pipe

roff 系 統 由 預 處 理 器 (preprocessor), roff 排 版 程 序 和 後 處 理 器 (postprocessor) 組 成 。 這 種 結 構 使 用 了 大 量 的 管 道 piping 機 制 , 意 思 是 , 一 系 列 的 程 序 陸 續 地 被 調 用 , 隊 列 中 的 每 個 程 序 的 輸 出 就 作 爲 下 一 個 程 序 的 輸 入

sh# cat file | ... | preproc | ... | troff options | postproc 預 處 理 器 產 生 roff 代 碼 , 傳 給 一 個 roff 處 理 器 (例 如 , troff), 然 後 roff 處 理 器 接 下 來 產 生 中 間 輸 出 , 傳 給 一 個 後 處 理 器 程 序 , 用 來 打 印 或 者 產 生 最 終 輸 出 所 有 這 些 組 件 都 使 用 它 們 自 己 的 程 序 語 言 ; 每 種 語 言 是 與 其 他 組 件 完 全 無 關 的 。 此 外 , 還 可 以 包 括 爲 特 殊 目 標 而 製 作 (tailor) 的 roff 宏 包 大 多 數 roff 文 檔 中 摻 雜 着 使 用 一 些 包 中 的 宏 、 一 個 或 多 個 預 處 理 器 的 代 碼 , 還 會 添 加 roff 語 言 中 的 一 些 元 素 。 用 戶 很 少 需 要 用 到 roff 排 版 語 言 的 完 整 功 能 ; 只 有 宏 包 的 作 者 需 要 知 道 底 層 細 節 (gory details) 預 處 理 器 Preprocessors 預 處 理 器 是 任 何 產 生 符 合 roff 排 版 語 言 語 法 的 輸 出 的 程 序 。 每 個 預 處 理 器 都 有 它 自 己 的 語 言 , 在 預 處 理 器 運 行 時 被 翻 譯 爲 roff 代 碼 。 roff 文 檔 中 可 以 包 含 以 這 種 語 言 寫 成 的 片 段 ; 它 們 可 以 被 特 殊 的 roff 命 令 或 宏 識 別 (they are identified by special roff requests or macros)。 加 入 了 預 處 理 器 代 碼 的 文 檔 必 須 通 過 所 有 相 應 的 預 處 理 器 處 理 之 後 , 才 能 傳 給 真 正 的 roff 排 版 程 序 , 因 爲 真 正 的 roff 排 版 程 序 會 忽 略 所 有 陌 生 的 代 碼 。 預 處 理 器 只 會 分 析 並 轉 換 指 定 由 它 處 理 的 文 檔 部 分 有 大 量 的 自 由 /商 業 roff 預 處 理 器 。 一 些 不 能 在 所 有 系 統 上 使 用 , 還 有 一 些 預 處 理 器 被 認 爲 是 roff 系 統 不 可 分 割 的 部 分 。 傳 統 的 預 處 理 器 有

tbl 製 表

(table)

eqn 數 學 公

式 (mathematical formulæ)
pic
繪 圖 (diagram)

refer 書 目 索

引 (bibliographic references)

soelim 包 含 標 準 位

置 的 宏 文 件 (macro) 其 他 已 知 預 處 理 器 , 但 不 是 在 所 有 系 統 上 都 可 用 , 包 括

chem 化 學 公 式

(chemical formulæ)

grap 構 造 圖 元

(graphical elements)

grn 插 入

gremlin(1) 圖 片 排 版 程 序 Formatter Programs

A roff formatter 排 版 程 序 是 一 個 解 釋 用 roff 排 版 語 言 或 roff 宏 包 寫 成 的 文 檔 的 程 序 。 它 產 生 中 間 結 果 intermediate output, 將 送 入 單 一 設 備 後 處 理 器 。 後 處 理 器 必 須 在 排 版 程 序 的 命 令 行 選 項 中 指 定 。 文 檔 必 須 已 經 通 過 了 所 有 需 要 的 預 處 理 器 處 理

roff 排 版 程 序 的 輸 出 以 另 外 一 種 語 言 表 示 : intermediate output formattroff output. 這 種 語 言 最 初 詳 述 在 [CSTR #97] 中 ; 它 的 GNU 擴 展 記 載 在 groff_out(5) 中 。 中 間 輸 出 語 言 與 高 級 的 roff 語 言 相 比 像 一 種 彙 編 指 令 語 言 。 產 生 的 中 間 輸 出 是 爲 一 種 特 定 的 設 備 優 化 過 的 , 但 是 對 於 所 有 設 備 , 這 種 語 言 都 適 用

roff 排 版 程 序 是 整 個 roff 系 統 的 核 心 。 傳 統 roff 有 兩 個 排 版 程 序 : 對 應 字 符 設 備 的 nroff 和 對 應 圖 形 設 備 的 troff 通 常 , troff 這 個 名 字 泛 指 這 兩 種 排 版 程 序 (is used as a general term to refer to both formatters)。 設 備 後 處 理 器 Devices and Postprocessors 設 備 是 類 似 打 印 機 、 字 符 或 圖 形 終 端 等 的 硬 件 接 口 , 或 者 是 用 於 轉 換 爲 另 一 種 字 符 或 圖 形 設 備 的 軟 件 接 口 後 處 理 器 是 將 troff 輸 出 轉 化 爲 一 種 適 於 某 種 特 殊 設 備 的 格 式 的 程 序 。 對 於 輸 出 目 標 來 說 , roff 後 處 理 器 像 是 它 們 的 設 備 驅 動 每 種 設 備 都 有 爲 其 優 化 的 後 處 理 器 程 序 。 . 後 處 理 器 解 釋 中 間 輸 出 , 產 生 設 備 相 關 的 代 碼 , 傳 送 給 設 備 設 備 名 和 後 處 理 器 程 序 的 名 稱 是 不 固 定 的 , 因 爲 它 們 依 賴 於 計 算 機 的 軟 硬 件 的 能 力 。 例 如 , [CSTR #54] 中 提 到 的 傳 統 的 設 備 名 已 經 有 了 極 大 的 改 變 。 舊 的 硬 件 不 再 存 在 , 舊 的 圖 形 轉 換 程 序 與 現 代 同 等 功 能 的 程 序 相 比 太 不 精 確 了 例 如 , Postscript 設 備 post 在 傳 統 troff 中 分 辨 率 是 720, 而 groff 的 ps 設 備 是 72000, 提 高 了 100 倍 現 在 , 操 作 系 統 爲 大 多 數 類 似 打 印 機 的 硬 件 提 供 了 設 備 驅 動 , 因 此 不 必 爲 每 個 打 印 機 寫 一 個 特 殊 的 後 處 理 器

roff 編 程 ROFF PROGRAMMING

roff 文 檔 是 加 入 了 roff 排 版 元 素 的 普 通 文 檔 。 roff 排 版 語 言 非 常 強 大 ; 它 幾 乎 是 一 個 完 整 的 程 序 語 言 , 並 且 提 供 了 擴 充 自 身 的 元 素 。 使 用 這 些 元 素 , 就 可 以 開 發 爲 特 殊 程 序 定 製 的 宏 包 。 這 樣 的 宏 包 比 普 通 的 roff 要 容 易 上 手 得 多 。 所 以 大 多 數 人 會 選 擇 一 中 宏 包 , 不 用 去 關 心 roff 語 言 的 內 部 實 現 宏 包 Macro Packages 宏 包 是 一 些 適 於 以 便 利 的 辦 法 格 式 化 某 種 特 殊 文 檔 的 宏 的 集 合 。 它 們 簡 化 了 roff 的 使 用 。 一 個 包 的 宏 定 義 保 存 在 一 個 叫 做 name.tmac 的 文 件 中 (傳 統 的 命 名 是 tmac.name). 所 有 tmac 文 件 保 存 在 標 準 位 置 的 一 個 或 多 個 目 錄 中 。 有 關 宏 包 的 命 名 和 位 置 的 細 節 可 以 看 groff_tmac(5). 文 檔 中 用 到 的 宏 包 可 以 使 用 命 令 行 選 項 -m 提 供 給 排 版 程 序 , 參 見 troff(1), 它 們 也 可 以 在 文 檔 中 指 定 , 使 用 roff 語 言 的 “包 含 文 件 ” 命 令 , 參 見 groff(7). 著 名 的 傳 統 宏 包 有 man 用 來 處 理 傳 統 手 冊 頁 mdoc 處 理 BSD 樣 式 的 手 冊 頁 ; 此 類 書 籍 、 文 檔 和 信 件 的 宏 集 合 是 me (命 名 也 許 是 根 據 它 的 創 造 者 之 名 Eric Allman 而 來 ), ms (命 名 來 自 Manuscript Macros), 還 有 mm (命 名 來 自 Memorandum Macros).

roff 排 版 語 言 The roff Formatting Language 傳 統 的 roff 排 版 語 言 記 述 在 troff 用 戶 手 冊 Troff User’s Manual [CSTR #54] 中 . roff 語 言 是 完 整 的 編 程 語 言 , 提 供 了 命 令 (request), 宏 定 義 , 轉 義 序 列 (escape sequence), 字 符 串 變 量 , 數 字 或 數 量 寄 存 器 (number or size registers), 還 有 流 程 控 制 語 句

Requests “命 令 ” 是 預 定 義 的 基 礎 的 排 版 命 令 , 與 shell 提 示 下 的 命 令 類 似 。 用 戶 可 以 定 義 類 似 “命 令 ” 的 元 素 , 使 用 roff 的 “預 定 義 ” 元 素 。 用 戶 定 義 的 命 令 就 被 叫 做 “宏 ” macros. 文 檔 作 者 不 會 體 會 到 命 令 和 宏 之 間 用 法 的 任 何 區 別 ; 它 們 都 寫 在 一 行 中 , 並 以 一 個 點 (dot, ’.’) 開 始

Escape sequences “轉 義 序 列 ” 是 以 反 斜 槓 (backslash, ’\’. ) 開 始 的 roff 元 素 。 它 們 可 以 被 插 入 到 任 何 地 方 , 包 括 文 本 的 一 行 中 間 。 它 們 用 來 實 現 不 同 的 功 能 , 可 以 使 用 \( 插 入 非 ASCII 字 符 , 使 用 \f 改 變 字 體 , 使 用 \" 插 入 行 內 註 釋 , 它 們 也 可 以 轉 義 特 殊 的 控 制 字 符 , 像 這 樣 \\, 還 有 很 多 很 多 其 他 的 功 能

Strings “字 符 串 ” 是 存 儲 一 個 字 符 串 的 變 量 。 字 符 串 以 .ds 命 令 存 儲 。 存 儲 的 字 符 串 可 以 用 \* 轉 義 序 列 獲 得

Registers “寄 存 器 ” 存 儲 數 字 和 數 量 。 寄 存 器 可 以 用 .nr 命 令 設 置 , 然 後 用 控 制 序 列 \n 來 獲 得 它 的 值

文 件 擴 展 名 FILE NAME EXTENSIONS

手 冊 頁 使 用 章 節 號 作 爲 文 件 擴 展 名 , 例 如 本 文 檔 的 文 件 名 是 roff.7, 也 就 是 說 它 放 在 手 冊 頁 的 第  7 章 傳 統 的 宏 包 使 用 包 名 稱 作 爲 文 件 擴 展 名 , 例 如 file.me 意 思 是 使 用 了 me 宏 包 的 文 件 , file.mm 使 用 了 宏 包 mm, file.ms 用 的 是 ms, file.pic 則 是 pic 等 等 但 是 沒 有 roff 文 檔 統 一 的 命 名 方 式 , 儘 管 file.tr 用 於 troff file 在 現 在 和 當 時 都 是 一 樣 的 也 許 應 當 有 roff 文 件 擴 展 名 的 一 個 標 準 文 件 擴 展 名 與 less(1) 格 式 化 工 具 結 合 , 會 非 常 好 用 。 它 提 供 了 用 單 一 的 方 式 打 開 各 種 輸 入 的 可 能 性 , 方 法 是 定 義 一 個 shell 環 境 變 量 LESSOPEN. 這 種 辦 法 沒 有 什 麼 文 檔 , 這 是 一 個 例 子 :

sh# LESSOPEN=’|lesspipe %s’

lesspipe 可 以 是 一 個 系 統 提 供 的 命 令 或 者 是 你 自 己 的 腳 本 。

編 輯 EDITING ROFF

最 好 的 roff 文 檔 編 輯 器 是 Emacs, 參 見 emacs(1). 它 提 供 了 nroff 模 式 , 適 於 所 有 種 類 的 roff “方 言 ”。 可 以 用 下 面 的 命 令 來 激 活 這 種 模 式 當 用 Emacs 編 輯 文 檔 時 可 以 輸 入 ’M-x nroff-mode’ 來 改 變 模 式 , 這 裏 M-x 意 思 是 按 住 Meta 鍵 (或 Alt) 同 時 點 一 下 x 鍵 也 可 以 在 編 輯 器 加 載 文 件 的 時 候 , 自 動 改 變 模 式

• 最 好 的 辦 法 是 將 下 面 三 行 註 釋 包 含 在 文 件 末 尾

.\" Local Variables:
.\" mode: nroff
.\" End:

• 有 一 系 列 的 文 件 擴 展 名 , 例 如 手 冊 頁 的 擴 展 名 , 會 自 動 觸 發

nroff 模 式

• 理 論 上 , 可 以 將 下 面 的 序 列

.\" -*- nroff -*- 作 爲 文 件 的 第 一 行 , 也 可 以 使 emacs 在 加 載 文 件 時 啓 用 nroff 模 式 。 不 幸 的 是 , 一 些 程 序 例 如 man 在 這 種 方 法 中 會 出 錯 ; 因 此 請 不 要 用 它 所 有 的 roff 排 版 程 序 都 提 供 了 自 動 的 斷 行 以 及 水 平 和 豎 直 間 距 。 爲 了 不 干 擾 它 的 功 能 , 應 當 注 意 以 下 幾 點 :

• 不 要 在

roff 文 檔 中 包 含 空 行 或 只 包 含 空 格 的 行 , 而 是 使 用 “空 行 ”命 令 (一 行

中 只 包 含 一 個 點 ), 或 者 一 行 註 釋 .\" (如 果 需 要 一 個 構 造 元 素 的 話 )

• 不 要 在 行 首 用 空 格 , 因 爲 這 會 導 致 不 可 預 測 的 行 爲 。 段 落 縮 進 可 以 以 受 控 的 方 式 , 用

roff 命 令 構 造 出 來

• 每 句 話 應 當 放 到 自 己 的 一 行 中 , 因 爲 句 號 後 面 的 空 格 的 處 理 方 法 是 根 據 它 結 束 的 是 短 語 還 是 句 子 而 不 同 的 。 要 區 別 這 兩 種 情 況 , 在 每 句 話 後 面 加 上 一 個 換 行

• 另 外 要 使 用

Emacs 的 auto-fill 模 式 的 話 , 最 好 在 每 句 話 後 面 添 加 一 個 空 的 roff 命 令 (一 行 中 只 包 含 一 個 點 ) 下 面 的 例 子 顯 示 了 最 佳 的 roff 編 輯 習 慣 是 怎 樣 的 這 是 一 個 roff 文 檔 的 例 子 .
. 這 是 同 一 段 中 的 下 一 句
.
. 這 是 下 一 個 句 子 , 它 比 較 長 , 分 成 了 多 行 ; 類 似
’cf.’ 這 樣 的 短 語 可 以 很 容 易 地 識 別 , 因 爲 其 中 的 “點 ”後 面 沒 有 換 行
.
.
(在 輸 出 時 , 它 們 仍 會 在 同 一 段 中 .)
.
(譯 註 : 如 果 使 用 中 文 的 標 點 “。 ”就 不 用 考 慮 這 些 , 但 是 每 句 話 後 面 換 行 總 是 個 好 主 意 。 少 用
’.’ 爲 妙 ) 除 了 Emacs, 其 他 一 些 編 輯 器 也 提 供 了 nroff 格 式 文 件 的 支 持 , 例 如 vim(1), 它 是 vi(1) 程 序 的 擴 展

BUGS

UNIX® 是 Open Group 的 註 冊 商 標 。 但 是 在 Caldera 在 2001 年 收 購 SCO UNIX 之 後 , 事 情 發 生 了 極 大 的 好 轉

(譯 註 : 爲 什 麼 2003 年 SCO 又 會 成 爲 M$ 的 走 狗 呢 ?)

參 見 SEE ALSO

有 大 量 的 講 述 roff 的 文 檔 。 講 述 傳 統 troff 的 原 始 文 檔 仍 可 獲 得 , groff 的 所 有 方 面 也 都 詳 細 地 記 錄 在 文 檔 中

Internet sites
troff.org

http://www.troff.org">“歷史上的 troff” 提 供 了 roff 所 有 歷 史 方 面 的 概 述 和 指 引 。 這 個 網 站 仍 在 建 設 ; 但 是 , 它 將 成 爲 roff 歷 史 的 主 要 來 源

Multics

http://www.multicians.org">“Multics 的官方站點” 包 含 很 多 MIT 的 項 目 的 信 息 , CTSS, Multics, 早 期 的 Unix, 還 包 括 runoff; 尤 其 有 用 的 是 一 個 術 語 字 典 , 還 有 很 多 到 古 老 的 文 檔 的 鏈 接

Unix Archive

http://www.tuhs.org/Archive/">“古老的 Unix 的檔案館” 提 供 了 古 老 的 Unix 的 源 碼 和 一 些 二 進 制 文 件 (包 括 troff 的 源 碼 和 它 的 文 檔 ), 它 們 是 Caldera 自 2001 年 以 來 公 開 的 , 例 如 著 名 的 Unix 版 本  7 的 PDP-11 平 臺 版 本 位 置 是 http://www.tuhs.org/Archive/PDP-11/Trees/V7">Unix V7 site.

Developers at AT&T Bell Labs

http://cm.bell-labs.com/cm/index.html">“貝爾實驗室計算和數學科學研究所” 提 供 了 搜 索 早 期 開 發 者 信 息 的 功 能

Plan 9

http://plan9.bell-labs.com">“Plan 9 操作系統” AT&T Bell Labs 貝 爾 實 驗 室 的 作 品

runoff

http://web.mit.edu/Saltzer/www/publications/pubs.html">“Jerry Saltzer 的主頁” 保 存 了 古 老 的 runoff 排 版 語 言 寫 成 的 一 些 文 檔

CSTR Papers

http://cm.bell-labs.com/cm/cs/cstr.html">“貝爾實驗室 CSTR 網站” 保 存 了 原 始 的 troff 手 冊 (CSTR #54, #97, #114, #116, #122) 還 有 著 名 的 有 關 編 程 的 歷 史 文 檔

GNU roff

http://www.gnu.org/software/groff">“groff 的官方網站” 提 供 了 自 由 的 roff 實 現 : groff, 並 且 它 是 roff 的 事 實 標 準 歷 史 文 檔 Historical roff Documentation 很 多 歷 史 文 檔 仍 然 可 以 在 線 獲 得 。 troff 語 言 主 要 的 兩 部 手 冊 是

[CSTR #54]

J. F. Osanna, http://cm.bell-labs.com/cm/cs/54.ps">Nroff/Troff User's Manual; (《 用 戶 手 冊 》 ) Bell Labs, 1976; revised by Brian Kernighan, 1992.

[CSTR #97]

Brian Kernighan, http://cm.bell-labs.com/cm/cs/97.ps">A Typesetter-independent TROFF, (《 設 備 無 關 的 troff》 ) Bell Labs, 1981, revised March 1982. 將 roff 作 爲 一 種 “小 語 言 ”("little language") 來 講 述 的 論 文 有

[CSTR #114]

Jon L. Bentley and Brian W. Kernighan, http://cm.bell-labs.com/cm/cs/114.ps">GRAP — A Language for Typesetting Graphs; (《 grap: 一 種 圖 形 排 版 語 言 》 ) Bell Labs, August 1984.

[CSTR #116]

Brian W. Kernighan, http://cm.bell-labs.com/cm/cs/116.ps">PIC -- A Graphics Language for Typesetting; (《 pic: 一 種 排 版 用 的 圖 形 控 制 語 言 》 ) Bell Labs, December 1984.

[CSTR #122]

J. L. Bentley, L. W. Jelinski, and B. W. Kernighan, http://cm.bell-labs.com/cm/cs/122.ps">CHEM — A Program for Typesetting Chemical Structure Diagrams, Computers and Chemistry; (《 chem: 排 版 化 學 結 構 圖 的 程 序 , 計 算 機 與 化 學 》 ) Bell Labs, April 1986. 手 冊 頁 Manual Pages 由 於 它 結 構 複 雜 , 完 整 的 roff 系 統 包 含 很 多 很 多 手 冊 頁 , 每 一 個 都 描 述 了 roff 的 一 個 方 面 。 不 幸 的 是 , 不 同 的 roff 實 現 之 間 , 它 們 的 手 冊 沒 有 相 同 的 命 名 格 式 在 groff 中 , 手 冊 頁 groff(1) 包 含 了 groff 相 關 的 所 有 文 檔 的 索 引 其 他 系 統 中 , 你 需 要 自 己 探 索 , 但 是 troff(1) 是 個 很 好 的 起 點

作 者 AUTHORS

Copyright (C) 2000, 2001, 2002 Free Software Foundation, Inc.

This document is distributed under the terms of the FDL (GNU Free Documentation License) version 1.1 or later. 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. 此 文 檔 是 groff, GNU roff 套 件 的 一 部 分 。 它 的 作 者 是 bwarken [AT] mayn.de">Bernd Warken; 它 的 管 理 者 是 wl [AT] gnu.org">Werner Lemberg.

[中 文 版 維 護 人 ]

bbbush <bbbush [AT] 163.com>

[中 文 版 最 新 更 新 ]

2003.11.28

《 中 國 linux論 壇 man手 冊 翻 譯 計 劃 》 :

http://cmpp.linuxforum.net

本 頁 面 中 文 版 由 中 文 man 手 冊 頁 計 劃 提 供 。 中 文 man 手 冊 頁 計 劃 : https://github.com/man-pages-zh/manpages-zh