Manpages

名 称

manpath - 确 定 手 册 页 的 搜 索 路 径

概 述

manpath [-qgdc?V] [-m 系 统 [,...]] [-C 文 件 ]

描 述

如 果 设 置 了 $MANPATHmanpath 只 会 显 示 其 内 容 并 显 示 一 条 警 告 。 如 果 未 设 置 , manpath 会 确 定 一 个 合 适 的 手 册 页 层 次 结 构 搜 索 路 径 并 显 示 结 果 。

The colon-delimited path is determined using information gained from the man-db configuration file – (/etc/manpath.config) and the user’s environment.

选 项

-q, --quiet 不 显 示 警 告 。
-d
, --debug 打 印 调 试 信 息 。
-c
, --catpath 生 成 针 对 manpath 的 catpath。 一 旦 确 定 了 manpath, 每 个 路 径 元 素 将 转 换 为 它 的 相 对 catpath。
-g
, --global 在 man-db 配 置 文 件 中 生 成 一 个 名 为 “global”的 , 包 含 所 有 路 径 的 manpath。
-m
系 统 [,...], --systems=系 统 [,...] 如 果 此 系 统 可 以 访 问 其 他 操 作 系 统 的 手 册 页 层 次 结 构 , 可 以 使 用 此 选 项 将 它 们 包 含 在 manpath 的 输 出 中 。 要 包 含 NewOS 的 手 册 页 层 次 结 构 , 使 用 -m NewOS 选 项 。 指 定 的 系 统 选 项 可 以 是 逗 号 分 隔 的 操 作 系 统 名 称 组 合 。 要 包 括 本 地 操 作 系 统 的 手 册 页 层 次 结 构 , 可 以 在 参 数 字 符 串 中 包 含 系 统 名 man。 此 选 项 会 覆 盖 $SYSTEM 环 境 变 量 。
-C 
文 件--config-file=文 件 使 用 此 用 户 配 置 文 件 代 替 默 认 的 ~/.manpath
-?
, --help 打 印 帮 助 消 息 并 退 出 。
--usage
打 印 简 短 的 帮 助 消 息 并 退 出 。
-V
, --version 显 示 版 本 信 息 。

环 境

MANPATH 如 果 设 置 了 $MANPATHmanpath 显 示 它 的 值 , 而 不 是 在 运 行 时 确 定 它 。 如 果 $MANPATH 前 缀 是 冒 号 , 则 变 量 的 值 会 追 加 到 从 配 置 文 件 内 容 确 定 的 列 表 之 后 。 如 果 冒 号 在 变 量 值 的 结 尾 , 则 确 定 的 列 表 会 追 加 到 变 量 内 容 之 后 。 如 果 变 量 的 值 包 含 双 冒 号 (::), 则 确 定 的 列 表 会 插 入 值 的 中 间 ( 两 个 冒 号 间 ) 。

SYSTEM 如 果 设 置 了

$SYSTEM 环 境 变 量 , 其 效 果 将 与 -m 选 项 的 参 数 相 同 。

文 件

/etc/manpath.config

man-db 配 置 文 件 。

亦 见

apropos(1), man(1), whatis(1)

作 者

Wilf. (G.Wilford [AT] ee.uk).
Fabrizio Polacco (fpolacco [AT] debian.org).
Colin Watson (cjwatson [AT] debian.org).

BUGS

https://savannah.nongnu.org/bugs/?group=man-db

COMMENTS