Manpages

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 變 量 ) 。 若 不 指 定 此 參 數 , 則 使 用 MANPAGERPAGER 環 境 變 量 中 的 設 置 。 此 選 項 的 預 設 的 顯 示 方 式 為 /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

環 境 變 量 NLAPATHLC_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 第 一 版

《 中 國 Linux論 壇 man手 冊 頁 翻 譯 計 劃 》

http://cmpp.linuxforum.net

COMMENTS