NAME
man −
格 式 化 並 顯 示
在 線 幫 助 手 冊
頁
manpath − 定 義 使 用 者
查 找 man手 冊 頁 的
路 徑
總 覽
man [-acdfFhkKtwW] [-m 系 統 名 ] [-p <前 處 理 程 式 >] [-C <配 置 檔 案 >] [-M <路 徑 >] [-P <瀏 覽 方 式 >] [-S <區 段 清 單 >] [區 段 名 稱 ] 幫 助 主 題 ...
描 述
man 格 式 化 並 顯 示 在 線 幫 助 手 冊 頁 面 。 此 版 本 支 持 MANPATH 和 （ MAN） PAGER 環 境 變 量 ， 因 此 ， 你 可 以 擁 有 你 自 己 的 一 系 列 man 手 冊 頁 並 決 定 使 用 哪 個 程 式 來 顯 示 此 格 式 的 頁 面 。 如 果 定 義 了 區 段 ， man 將 只 查 找 在 指 定 區 段 內 的 文 件 。 你 也 可 以 通 過 命 令 行 或 環 境 變 量 來 指 定 查 找 區 段 的 順 序 和 預 定 義 將 要 執 行 的 程 式 。 如 果 主 題 中 有 “/”符 號 ， 則 將 其 作 為 檔 名 的 一 部 分 處 理 ， 也 就 是 說 你 可 以 用 man ./foo.5 也 可 以 用 man /cd/foo/bar.1.gz 來 查 看 各 man 文 件 。
選 項
-C 配 置 檔 案
定 義 man.conf供 使 用 ； 預 設 使 用 的 是 /etc/man.config 。 （ 參 見 man.conf(5)） 。
-M 路 徑
定 義 一 組 查 找 man手 冊 頁 的 目 錄 。 如 果 沒 有 指 定 此 參 數 ， 系 統 環 境 變 量 MANPATH將 被 使 用 。 如 果 查 無 到 此 環 境 變 量 ， 則 按 預 設 /etc/man.config 檔 案 中 指 定 的 查 找 。 一 個 空 的 MANPATH 子 字 符 串 表 示 使 用 預 設 清 單 。
-P 瀏 覽 方 式
定 義 瀏 覽 的 方 式 。 此 選 項 將 覆 蓋 MANPAGER 環 境 變 量 （ 此 變 量 將 覆 蓋 PAGER 變 量 ） 。 若 不 指 定 此 參 數 ， 則 使 用 MANPAGER 或 PAGER 環 境 變 量 中 的 設 置 。 此 選 項 的 預 設 的 顯 示 方 式 為 /usr/bin/less-is。
-S 區 段 清 單
該 清 單
是 一 組 用 冒 號
分 隔 的 欲 查 找
的 手 冊 清 單 。
此 選 項 將 覆 蓋
MANSECT 環 境 變 量 。
有 些 指 令 或 程
式 可 能 有 一 個
以 上 的 主 題 ，
它 們 位 於 不 同
的 區 段 中 。 因
此 ， 要 查 看 較
後 的 區 段 ， 你
可 以 在 此 指 定
man 查 找 區 段 的
順 序 。 具 體 區
段 劃 分 如 下 所
示 ：
區 段 1： 使 用 者
指 令
區 段 2： 系 統 調
用
區 段 3： 程 式 庫
調 用
區 段 4： 設 備
區 段 5： 檔 案 格
式
區 段 6： 遊 戲
區 段 7： 雜 項
區 段 8： 系 統 指
令
區 段 9： 核 心 內
部 指 令
區 段 n： Tcl或 Tk指
令
|
-a |
預 設 情 況 下 ， man在 顯 示 完 每 一 個 所 查 到 的 man手 冊 頁 時 會 自 動 退 出 程 式 。 而 使 用 此 選 項 ， 則 可 使 man顯 示 所 有 與 此 主 題 相 匹 配 的 手 冊 頁 內 容 ， 而 不 僅 僅 是 第 一 項 。 | ||
|
-c |
即 使 已 存 在 最 近 已 排 版 過 的 幫 助 檔 案 （ 即 以 前 曾 查 詢 過 該 主 題 的 幫 助 文 件 ） ， 使 用 該 參 數 後 仍 會 再 次 執 行 一 次 排 版 操 作 。 此 參 數 適 用 於 已 排 版 過 的 幫 助 檔 案 已 損 壞 或 螢 幕 的 行 列 數 有 改 變 時 。 | ||
|
-d |
不 顯 示 幫 助 文 件 的 具 體 內 容 ， 只 顯 示 調 試 排 錯 信 息 。 | ||
|
-D |
既 顯 示 幫 助 文 件 內 容 ， 同 時 又 顯 示 調 試 排 錯 信 息 。 | ||
|
-f |
相 當 於 運 行 whatis 的 操 作 。 即 ： 顯 示 工 具 指 令 與 工 具 程 式 的 簡 單 說 明 。 |
-F" 或 --preformat
只 進 行 格 式 化 操 作 ， 而 不 真 正 的 顯 示 出 來 。
|
-h |
顯 示 man的 語 法 和 參 數 說 明 ， 執 行 完 成 後 退 出 程 式 。 | ||
|
-k |
查 當 於 使 用 apropos 命 令 。 | ||
|
-K |
在 所 有 的 幫 助 檔 案 中 查 找 包 含 有 指 定 關 鍵 字 的 幫 助 文 件 。 此 操 作 可 能 很 慢 ， 所 以 在 使 用 此 參 數 時 最 好 配 合 -s 的 參 數 來 查 找 指 定 區 段 。 （ 這 只 是 一 個 粗 略 的 概 念 ， 在 作 者 本 人 的 機 器 上 每 分 鐘 可 查 500個 man文 件 。 ） | ||
|
-m |
系 統 名 定 義 所 要 查 找 的 man文 件 所 屬 的 系 統 名 。 | ||
|
-p |
字 串 定 義 在 排 版 幫 助 檔 案 這 前 所 要 執 行 的 預 處 理 程 式 的 次 序 。 不 是 所 有 的 安 裝 都 有 完 整 預 處 理 程 式 組 。 一 般 有 6個 預 處 理 程 式 ， 它 們 是 ： eqn(e)、 grap(g)、 pic(p)、 tbl(t)、 vgrind(v)和 reger(r)。 此 參 數 將 覆 蓋 環 境 變 量 MANROFFSEQ。 | ||
|
-t |
使 用 /usr/bin/groff - Tps - mandoc 來 排 版 man手 冊 頁 ， 並 輸 出 到 標 準 輸 出 。 從 /usr/bin/groff - Tpa - madoc 輸 出 的 內 容 可 能 需 要 某 些 其 它 過 濾 才 能 真 正 輸 出 到 標 準 輸 出 列 印 。 |
-w" 或 --path
不 顯 示 幫 助 文 件 的 具 體 內 容 而 只 顯 示 相 應 幫 助 主 題 檔 案 的 位 置 。 如 果 沒 有 給 定 參 數 ， 則 將 在 標 準 輸 出 顯 示 一 組 由 man所 查 到 的 相 匹 配 的 man 文 件 所 在 目 錄 。 如 果 命 令 manpath是 一 個 到 m an的 鏈 接 ， 那 麼 執 行 “manpath”就 相 當 於 執 行 “man --path”。
|
-W |
相 當 於 -w參 數 ， 但 所 顯 示 的 內 容 以 分 行 方 式 顯 示 。 此 參 數 方 便 其 它 指 定 或 程 式 對 其 輸 出 做 進 一 步 處 理 ， 如 ： man -aW man | xargs ls -l |
CAT頁
Man 會 試 著 對 所 查 的 文 件 進 行 保 存 ， 為 的 是 便 於 下 次 使 用 此 幫 助 頁 時 可 節 約 格 式 化 時 間 。 傳 統 上 ， 被 格 式 化 的 DIR/manX文 件 會 被 存 儲 在 DIR/catX中 ， 但 你 可 以 在 /etc/man.config 配 置 文 件 中 指 定 其 它 的 目 錄 。 如 果 所 需 的 cat目 錄 不 存 在 時 ， 系 統 就 不 對 格 式 化 後 的 man文 件 進 行 保 存 。
對 於 使 用 man命 令 的 人 ， man命 令 可 能 對 其 進 行 setuid的 操 作 。 因 此 ， 如 果 一 個 cat目 錄 屬 於 man並 且 其 模 式 是 0755（ 只 有 man對 其 有 寫 的 權 限 ） ， 而 且 ， cat檔 案 也 屬 於 man和 其 模 式 是 064 4或 0444（ 只 有 man對 其 有 寫 權 限 或 根 本 就 沒 有 寫 權 限 ） ， 則 普 通 用 就 不 能 更 改 cat文 件 頁 ， 也 不 能 在 此 目 錄 中 存 放 其 它 檔 案 。 而 如 果 man沒 有 執 行 setuid的 操 作 ， 那 麼 ， 為 了 能 使 所 有 使 用 者 都 能 存 放 cat頁 到 cat目 錄 ， 則 必 須 將 這 個 cat目 錄 設 置 成 0777模 式 。
參 數 -c 可 以 強 制 生 成 一 個 新 的 man頁 ， 既 使 已 經 有 一 個 cat頁 存 在 。
環 境 變 量
MANPATH
如 果 MANPATH 有 定 義 ， 那 麼 它 的 值 將 在 查 找 man文 件 頁 時 做 為 搜 索 路 徑 來 使 用 。
MANROFFSEQ
如 果 MANROFFSEQ 有 定 義 ， 則 此 變 量 的 值 將 用 來 決 定 在 nroff或 troff執 行 前 將 要 執 行 的 預 處 理 程 式 的 次 序 。 預 設 情 況 下 ， 手 冊 頁 會 在 nroff處 理 前 選 取 進 行 表 格 處 理 。
MANSECT
如 果 MANSECT 有 定 義 ， 它 的 值 將 決 定 man有 搜 索 時 的 查 找 區 段 。
MANWIDTH
如 果 MANWIDTH有 定 義 ， 它 的 值 將 決 定 顯 示 man手 冊 頁 時 的 寬 度 。 否 則 ， 將 是 以 全 屏 的 方 式 來 顯 示 。
MANPAGER
如 果 MANPAGER 有 定 義 ， 它 的 值 將 指 定 用 來 顯 示 man文 件 的 程 式 。 如 果 沒 有 在 此 指 定 ， 那 麼 將 使 用 由 PAGER變 量 指 定 的 程 式 。 如 果 還 是 沒 有 指 定 ， 那 麼 會 預 設 使 用 /usr/bin/less -is 。
|
LANG |
如 果 LANG 有 定 義 ， 它 的 值 將 指 定 man在 查 找 文 件 時 首 先 查 找 的 子 目 錄 。 因 此 ， 命 令 “LAN G=dk man 1 foo”會 使 man在 查 找 man頁 時 首 先 查 找 ../dk/man1/foo.1， 如 果 在 其 中 沒 有 找 到 相 關 文 件 ， 則 查 找 ../man/foo.1， 此 目 錄 是 由 查 找 路 徑 指 定 的 。 |
NLAPATH， LC_MESSAGES， LANG
環 境 變 量 NLAPATH 和 LC_MESSAGES （ 或 當 後 一 個 不 存 在 時 使 用 LANG ） 充 當 了 定 位 文 件 目 錄 的 角 色 。 （ 但 英 文 信 息 是 編 譯 進 命 令 的 ， 所 以 針 對 英 文 而 言 ， 就 沒 有 目 錄 存 在 ） 。 注 意 ， 像 col (1)這 樣 被 man調 用 的 程 式 也 使 用 像 LC_CTYPE 這 樣 的 變 量 。
|
PATH |
變 量 PATH 是 在 解 釋 查 找 man手 冊 頁 路 徑 時 使 用 的 。 | ||
|
SYSTEM |
變 量 SYSTEM 是 用 來 得 到 預 設 的 系 統 名 （ 用 -m參 數 可 以 得 到 同 樣 的 效 果 ） 。 |
另 見
apropos(1),whatis(1),less(1),groff(1).
BUGS
選 項 -t 只 能 使 用 在 裝 有 類 troff程 式 的 環 境 中 。 如 果 在 你 的 顯 示 中 出 現 高 亮 度 的 255或 <AD>這 樣 的 字 符 而 不 是 連 字 符 ， 請 在 你 的 配 置 檔 案 中 寫 入 “LESSCHARSET=latin1”這 樣 的 環 境 變 量 。
技 巧
如 果 你 在 你 的 .emacs 檔 案 中 加 入 (global-set-key[(f1)](lambda()(interactive)(manuale ntry(current-word))))這 一 行 ， 則 當 你 按 F1鍵 時 會 自 動 跳 出 當 前 滑 鼠 指 向 的 相 應 程 式 的 man手 冊 頁 。
[中 文 版 維 護 人 ]
徐 明 <xuming [AT] users.net>
|
譯 者 ： |
所 羅 門 <solomen [AT] email.cn> |
[中 文 版 最 新 更 新 ]
2003/05/13 第 一 版