名 称
manpath - 格 式 化 /etc/manpath.config 文 件
描 述
manpath 配 置 文 件 是 手 册 页 工 具 程 序 用 来 在 运 行 时 访 问 用 户 的 manpath 的 。 它 指 示 了 哪 些 手 册 页 层 次 结 构 (manpath)应 视 为 系 统 层 次 结 构 , 并 向 它 们 分 配 用 于 保 存 cat 文 件 的 目 录 。 如 果 已 经 设 置 了 环 境 变 量 $MANPATH, /etc/manpath.config 中 包 含 的 信 息 不 会 覆 盖 它 。
格 式
当 前 支 持 以 下 字 段 类 型 :
# 注 释 空 行 或 以 |
# 开 头 的 行 将 视 为 注 释 并 忽 略 。 |
MANDATORY_MANPATH manpath_element
这 种 形 式 的 行
指 定 每 个 自 动
生 成 的 $MANPATH 应 包
含 的 manpath。 它 通 常
包 含 /usr/man。
MANPATH_MAP path_element manpath_element
这 种 形 式 的 行
将 设 置 $PATH 到
$MANPATH 的 映 射 。 对
于 在 用 户 $PATH 中
找 到 的 每 个
path_element, 会 将
manpath_element 添 加 到
$MANPATH。
MANDB_MAP manpath_element [
catpath_element ] 这 种 形 式
的 行 指 示 哪 些
manpath 视 为 系 统 manpath,
还 可 指 定 它 们
的 cat 文 件 保 存 在
哪 里 。 如 果 man
是 一 个 setuid 程 序 ,
此 字 段 类 型 将
尤 为 重 要 , 因
为 (当 在 系 统 配
置 文 件 /etc/manpath.config 而
不 是 每 个 用 户
配 置 文 件 .manpath 中
时 )它 指 示 哪 些
手 册 页 层 次 结
构 作 为 setuid 用 户 访
问 , 哪 些 作 为
调 用 用 户 访 问
。 系 统 手 册 页
层 次 结 构 通 常
保 存 在 /usr 下 ,
如 /usr/man, /usr/local/man 和
/usr/X11R6/man。 如 果 来
自 某 个 特 定
manpath_element 的 cat 页 面
不 保 存 , 或 保
存 在 传 统 位 置
, 可 以 忽 略
catpath_element。
Traditional cat placement would be impossible for read only mounted manual page hierarchies and because of this it is possible to specify any valid directory hierarchy for their storage. To observe the Linux FSSTND the keyword FSSTND can be used in place of an actual directory. 不 幸 的 是 , 需 要 指 定 所 有 系 统 man 目 录 树 的 路 径 , 包 括 替 代 的 操 作 系 统 路 径 , 如 /usr/man/sun 和 任 何 的 NLS 区 域 语 言 路 径 , 如 /usr/man/de_DE.88591。 由 于 是 按 写 的 顺 序 逐 行 解 析 的 , 因 此 必 须 先 列 出 作 为 另 一 层 次 结 构 的 次 级 结 构 的 manpath, 否 则 会 出 现 不 正 确 的 匹 配 。 例 如 , /usr/man/de_DE.88591 应 出 现 在 /usr/man 之 前 。
DEFINE 键
值 这 种 形 式
的 行 定 义 各 种
配 置 变 量 ; 请
查 看 默 认 的 配
置 文 件 了 解 手
册 分 页 工 具 使
用 了 哪 些 变 量
。 它 们 包 括 指
向 各 种 程 序 的
路 径 (如 grep 和
tbl), 和 这 些 程
序 的 默 认 参 数
集 。
SECTION 章 节 ... 这 种
形 式 的 行 定 义
手 册 章 节 的 搜
索 顺 序 。 如 果
配 置 文 件 中 没
有 SECTION 指 令 , 默
认 为 :
SECTION 1 n l 8 3 0 2 5 4 9 6 7 如 果 给 出 了 多 个 SECTION 指 令 , 它 们 的 章 节 列 表 会 被 合 并 。 如 果 某 个 特 定 扩 展 不 在 列 表 中 (像 1mh), 它 会 和 它 所 属 章 节 的 其 他 部 分 一 起 显 示 。 这 样 的 效 果 是 , 若 要 强 制 某 种 特 定 的 顺 序 , 您 只 需 明 确 列 出 扩 展 。 带 扩 展 的 章 节 通 常 应 该 与 其 主 章 节 相 邻 (如 “1 1mh 8 ...)。
SECTIONS 是 此 指 令 的 替 代 名 称 , 也 允 许 使 用 。
MINCATWIDTH 宽
度 如 果 终 端 宽
度 小 于 宽 度 ,
将 不 会 创 建 (若
缺 少 )或 显 示 cat 页
面 。 默 认 值 为
80。
MAXCATWIDTH 宽 度 如
果 终 端 宽 度 大
于 宽 度 , 将 不
会 创 建 (若 缺 少
)或 显 示 cat 页 面 。
默 认 值 为 80。
CATWIDTH 宽 度 如 果
宽 度 是 非 零 的
, 对 指 定 宽 度
的 终 端 将 总 是
格 式 化 cat 页 面 ,
不 管 实 际 使 用
的 终 端 宽 度 是
多 少 。 此 数 值
通 常 应 在 MINCATWIDTH
和 MAXCATWIDTH 设 置 的
范 围 之 内 。
NOCACHE 此 标 志 阻 止
man(1) 自 动 创 建 cat
页 面 。
BUGS
除 非 完 全 准 确 的 遵 守 了 这 些 规 则 , 否 则 手 册 分 页 工 具 会 工 作 不 正 常 。 这 些 规 则 过 于 复 杂 了 。
https://savannah.nongnu.org/bugs/?group=man-db