Manpages

名 称

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 兼 容 的 全 局 索 引 数 据 库 缓 存 。

亦 见

man(1), manpath(5), mandb(8)

作 者

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