创建用于手册的 cat 文件。
catman [ -n | -p | -w ] [ -MPath ] [ Section ... ]
catman 命令从 nroff 命令输入文件创建联机手册的预格式化版本。catman 命令检查手册每一页并重新创建那些其预格式化版本丢失或过期的页面。如果作了任何更改,catman 命令会重新创建 whatis 命令数据库。
-M Path | 更新位于由 Path 变量指定的目录集(缺省情况下为 /usr/share/man 目录)中的手册页面。Path 变量具有以冒号(:)来分隔目录名列表的形式。例如:
'/usr/local/man:/usr/share/man' 如果设置了环境变量 MANPATH,它的值用于缺省路径。如果 nroff 命令源文件包含如下的行: ' .so manx/yyy.x' 在 catx 目录中将产生连接至相应预格式化手册页面的符号链路。这样就可使用 rdist 命令来使得预格式化手册页面非常容易地分布在相关的机器组中。 nroff 命令源无需被分布至所有机器,这样就能节省相关的磁盘空间。 例如,拥有五台机器(称作 mach1 到 mach5)的本地网络中的 mach3 具有手册页 nroff 命令源。每天夜间,mach3 通过使用 cron 守护进程来运行 catman 命令并稍后使用同以下内容相似的 distfile 文件来运行 rdist 命令: MANSLAVES = (mach1 mach2 mach4 mach5) MANUALS = (/usr/share/man/cat[1-8no] /usr/share/man/whatis) ${MANUALS} -> ${MANSLAVES} install -R; notify root; |
-n | 防止 whatis 命令数据库的创建。 |
-p | 打印需要重新创建或更新的手册页面名称,但又不对它们进行重新创建或更新操作。 |
-w | 读取 /usr/share/man/cat?/*.* 和 /usr/share/man/man?/*.* 文件中的 BSE 样式的手册页面;然后读取安装在 /usr/share/man/info 目录下的超文本信息库并创建 /usr/share/man/whatis 数据库。如果设置了 MANPATH 环境变量,则会在 MANPATH 中出现的每个目录中创建不同的数据库。它们中的每一个都会从 cat?/*.* 和 man?/*.* 文件构建,以用于那个特定目录。如果在 MANPATH 中包括缺省的 /usr/share/man/whatis 数据库或如果未设置 MANPATH 环境变量,则 HTML 库信息会被构建至那个缺省数据库。 |
要只对手册的 1、2 和 3 节进行更新,输入:
catman 123
/usr/lbin/getNAME | 包含创建 whatis 数据库的命令。 |
/usr/share/man | 指定缺省的手册目录位置。 |
/usr/share/man/man?/*.* | 包含原始的(nroff 命令输入)手册章节。 |
/usr/share/man/cat?/*.* | 包含预格式化手册页面。 |
/usr/share/man/whatis | 包含 whatis 命令数据库。 |
/usr/lbin/mkwhatis | 包含用于构建 whatis 命令数据库的命令脚本。 |
cron 守护进程。
distfile 文件。