名 称
catman - 创 建 或 更 新 预 格 式 化 的 手 册 页
概 述
catman [-d?V] [-M 路 径 ] [-C 文 件 ] [章 节 ] ...
描 述
catman 用 于 创 建 最 新 的 预 格 式 化 手 册 页 集 合 (称 为 cat 页 面 )。 Cat 页 面 通 常 比 原 手 册 页 显 示 得 快 。 若 本 地 管 理 员 决 定 加 入 cat 页 面 支 持 ， 他 们 必 须 提 供 合 适 的 目 录 来 保 存 这 些 页 面 。
catman 的 可 用 选 项 为 要 预 格 式 化 的 手 册 页 层 次 结 构 和 章 节 。 默 认 的 层 次 结 构 是 那 些 在 man-db 配 置 文 件 中 指 定 的 系 统 层 次 结 构 ， 默 认 章 节 是 环 境 变 量 $MANSECT 中 以 冒 号 分 隔 的 内 容 或 编 译 进 man 的 标 准 集 合 (如 果 未 定 义 $MANSECT)。 给 catman 提 供 一 组 空 格 分 隔 的 章 节 名 会 覆 盖 以 上 两 个 选 项 。
catman 利 用 与 每 个 层 次 结 构 关 联 的 索 引 数 据 库 缓 存 来 确 定 需 要 格 式 化 哪 些 文 件 。
选 项
-d,
--debug 打 印 调 试 信
息 。
-M 路 径
, --manpath=路 径 指
定 替 代 的 手 册
页 层 次 结 构 搜
索 路 径 ， 以 冒
号 分 隔 。 默 认
情 况 下 ， 这 是 man-db
配 置 文 件 中 指
定 的 所 有 系 统
层 次 结 构 。
-C 文 件
, --config-file=文 件
使 用 此 用 户 配
置 文 件 代 替 默
认 的 ~/.manpath。
-?, --help 打 印 帮 助
消 息 并 退 出 。
--usage 打 印 简 短 的
帮 助 消 息 并 退
出 。
-V, --version 显 示 版 本
信 息 。
环 境
MANSECT
如 果 设 置 了
$MANSECT， 它 的 值 (以
冒 号 分 隔 的 章
节 列 表 )会 用 于
确 定 搜 索 哪 些
章 节 及 搜 索 顺
序 。 默 认 值 为
“1 n l 8 3 0 2 3type 3posix 3pm 3perl 3am 5 4 9 6
7”， 除 非 被
/etc/manpath.config 中 的 SECTION
指 令 覆 盖 。
MANPATH 如 果 设 置 了
$MANPATH 环 境 变 量 ，
它 的 值 将 被 解
释 为 要 使 用 的
， 以 冒 号 分 隔
的 手 册 页 层 次
结 构 搜 索 路 径
。 请 参 考 manpath(5)
中 的 搜 索 路 径
一 节 以 了 解 默
认 行 为 以 及 处
理 该 环 境 变 量
的 细 节 。
文 件
/etc/manpath.config
man-db 配 置 文 件 。
/usr/man/index.(bt|db|dir|pag)
传 统 的 全 局 索
引 数 据 库 缓 存
。
/var/catman/index.(bt|db|dir|pag) 替 代
的 或 FSSTND 兼 容 的 全
局 索 引 数 据 库
缓 存 。
亦 见
作 者
Wilf.
(G.Wilford [AT] ee.uk).
Fabrizio Polacco (fpolacco [AT] debian.org).
Colin Watson (cjwatson [AT] debian.org).
BUGS
https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db