显示线上求助手册
http://www.fanqiang.com (2001-06-11 16:10:00)
名称
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）