Linux命令Man解释:man:显示线上求助手册

名称
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）

原文转自：http://www.ltesting.net