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-692421-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