Linux命令Man解釋:man:顯示線上求助手冊

名稱 man-顯示線上求助手冊(manualpage)manpath-決定線上手冊的搜尋路徑 摘要 man[-acdfhkKtwW][-msystem][-pstring][-Cconfig_file][-Mpath][-Ppager][-Ssection_list][section]name... 描述 man是用來排版並顯示線上求助手冊,此版本了解MANPATH與(MAN)PAGE 名稱
man - 顯 示 線 上 求 助 手 冊 ( manual page ) manpath - 決 定 線 上 手 冊 的 搜 尋 路 徑

摘要
man [-acdfhkKtwW] [-m system] [-p string] [-C config_file] [-M path] [-P pager] [-S section_list] [section] name ...

描述
man 是 用 來 排 版 並 顯 示 線 上 求 助 手 冊 , 此 版 本 了 解 MANPATH 與 (MAN)PAGER 這 兩 個 環 境 變 數 , 所 以 你 可 以 擁 有 個 人 的 線 上 手 冊 , 並 選 擇 任 何 程 式 來 顯 示 已 排 版 的 手 冊 。 如 果 指 定 了 section , 則 man 只 會 顯 示 該 手 冊 的 特 定 章 節 。 您 也 可 以 利 用 選 項 或 是 環 境 變 數 來 指 定 搜 尋 的 次 序 或 是 排 版 之 前 的 處 理 工 具 。 如 果 name 包 含 了 `/' 則 man 會 先 搜 尋 所 指 定 的 檔 案 , 所 以 您 可 以 man ./foo.5 或 者 是 man /cd/foo/bar.1.gz 。

選項
-C config_file 指 定 設 定 檔 man.conf ; 內 定 值 是 /etc/man.conf。 (See man.conf(5) .)
-M
path 指 定 了 線 上 手 冊 的 搜 尋 路 徑 , 如 果 沒 有 指 定 則 使 用 環 境 變 數 MANPATH 的 設 定 ; 如 果 沒 有 使 用 MANPATH , 則 會 使 用 /usr/lib/man.conf 內 的 設 定 ; 如 果 MANPATH 是 空 字 串 則 表 示 使 用 內 定 值 。
-P
pager 指 定 使 用 何 種 pager . man 會 優 先 使 用 此 選 項 設 定 , 然 後 是 依 環 境 變 數 MANPAGER 設 定 , 然 後 是 環 境 變 數 PAGER ; man 內 定 使 用 /usr/bin/less -is 。
-S
section_list man 所 搜 尋 的 章 節 列 表 ( 以 冒 號 分 隔 ) , 此 選 項 會 覆 蓋 環 境 變 數 MANSECT 的 設 定 。
-a
man 內 定 在 顯 示 第 一 個 找 到 的 手 冊 之 後 就 會 停 止 搜 尋 , 使 用 此 選 項 會 強 迫 man 顯 示 所 有 符 合 name 的 線 上 手 冊 。
-c
即 使 有 最 新 的 cat page , 還 是 對 線 上 手 冊 重 新 作 排 版 , 本 選 項 在 螢 幕 的 行 列 數 改 變 時 或 已 排 版 的 線 上 手 冊 損 壞 時 特 別 有 意 義 。
-d
不 要 真 的 顯 示 線 上 手 冊 , 只 顯 示 除 錯 訊 息 。
-D
同 時 顯 示 線 上 手 冊 與 除 錯 訊 息 。
-f
功 能 同 whatis 。
-h
顯 示 求 助 訊 息 然 後 結 束 程 式 。
-k
功 能 同 apropos 。
-K
對 所 有 的 線 上 手 冊 搜 尋 所 指 定 的 字 串 。 警 告 : 本 功 能 回 應 速 度 可 能 很 慢 ! 如 果 指 定 section 會 對 速 度 有 幫 助 。
-m
system 依 所 指 定 的 system 名 稱 而 指 定 另 一 組 的 線 上 手 冊 。
-p
string 指 定 在 nroff 或 troff 之 前 所 執 行 的 處 理 程 式 不 是 所 有 的 安 裝 都 會 有 完 整 的 前 處 理 器 。 各 個 前 處 理 器 所 代 表 的 字 母 分 別 為 : eqn (e), grap (g), pic (p), tbl (t), vgrind (v), refer (r) . 本 選 項 覆 蓋 環 境 變 數 MANROFFSEQ 的 設 定 。
-t
使 用 /usr/bin/groff -Tps -mandoc 來 對 線 上 手 冊 排 版 , 並 將 結 果 顯 示 至 stdout 。 /usr/bin/groff -Tps -mandoc 的 輸 出 結 果 可 能 還 需 要 特 定 的 過 濾 器 才 能 列 印 ( 如 bg5ps ) 。
-w 或 --path
不 要 真 的 顯 示 線 上 手 冊, 但 顯 示 線 上 手 冊 的 位 置 . 如 果 沒 有 指 定 引 數 則 顯 示 man 所 搜 尋 的 目 錄 列 表 。 如 果 manpath 是 man 的 □ 結 , 則 玬anpath?功 能 同 玬an --path?。
-W
功 能 類 -w, 但 每 行 只 印 出 一 個 檔 名 , 不 印 出 額 外 的 訊 息 . 這 在 下 面 的 狀 況 特 別 有 用 : man -aW man | xargs ls -l 。


man 會 試 著 存 下 已 排 版 的 線 上 手 冊 , 以 節 省 下 回 排 版 所 需 要 的 時 間 。 傳 統 上 , 位 於 DIR/X 的 手 冊 在 排 版 完 成 後 會 存 於 DIR/catX , 但 在 這 裡 是 存 於 /var/ctaman/catX 。 如 果 系 統 沒 有 所 需 要 的 目 錄 , 則 不 會 有 任 何 cat page 存 檔 。

It is possible to make man suid to a user man. Then, if a cat directory has owner man and mode 0755 (only writable by man), and the cat files have owner man and mode 0644 or 0444 (only writable by man, or not writable at all), no ordinary user can change the cat pages or put other files in the cat directory. If man is not made suid, then a cat directory should have mode 0777 if all users should be able to leave cat pages there.

選 項 -c 強 迫 對 線 上 手 冊 重 新 作 排 版 。

環境變數
MANPATH MANPATH 用 來 設 定 man 的 搜 尋 路 徑 。
MANROFFSEQ
MANROFFSEQ 用 來 設 定 在 nroff 或 troff 執 行 前 所 需 要 的 前 處 理 器 。 內 定 在 nroff 前 會 先 執 行 table preprocessor 。
MANSECT
MANSECT 決 定 man 搜 尋 的 章 節 。
MANWIDTH
MANWIDTH 用 來 設 定 顯 示 的 寬 度 。 若 無 設 定 , 則 手 冊 會 填 滿 您 螢 幕 的 寬 度 。
MANPAGER
MANPAGER 決 定 了 顯 示 線 上 手 冊 的 工 具 。 如 果 無 MANPAGER 則 使 用 PAGER , 如 果 兩 者 皆 未 設 定 則 使 用 /usr/bin/less -is 。

LANG LANG 決 定 了 man 先 搜 尋 的 的 子 目 錄 的 名 稱 所 以 `LANG=dk man 1 foo' 會 使 man 先 搜 尋 [path]/dk/man1/foo.1 , 如 果 找 不 到 該 檔 , man 才 去 尋 找 [path]/man1/foo.1 , [path] 是 指 預 設 的 搜 尋 路 徑 。

NLSPATH, LC_MESSAGES, LANG
環 境 變 數 NLSPATH 與 LC_MESSAGES ( 如 果 LC_MESSAGE 不 存 在 則 使 用 LANG ) 用 來 指 定 訊 息 的 語 言 種 類 . ( 英 文 訊 息 是 編 譯 時 即 內 定 , 故 不 需 另 外 設 定 . ) 請 注 意 , man 所 呼 叫 的 程 式 , 如 col(1) 也 會 使 用 這 些 環 境 變 數 。

PATH PATH 是 用 來 設 定 man 的 搜 尋 線 上 手 冊 的 路 徑 。

SYSTEM SYSTEM 用 來 設 定 替 代 的 系 統 名 ( 此 為 選
項 -m 所 使 用 ) 。

相關說明
apropos(1) , whatis(1) , less(1) , groff(1) 。

臭蟲
選 項 -t 只 會 在 有 類 似 troff 工 具 存 在 時 才 有 功 用 。 在 gnome-help-browser 還 看 不 到 中 文 。 在 kdehelp 中 可 看 到 中 文 , 但 固 定 字 型 建 建 議 選 取 courier 或 lucidatyperiter 。 （BP 1.0）