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) 。
文章整理：西部数码--专业提供域名注册、虚拟主机服务
http://www.west263.com
以上信息与文章正文是不可分割的一部分,如果您要转载本文章,请保留以上信息，谢谢!
