如何手动安装手册页文件？

Question

如何在系统范围内安装手册页文件？

例如，如果我有一个手册页文件examplecommand.1，我如何安装它以便我可以只输入man examplecommand来查看它？

Answer 1

1. 首先，找出您的手册页属于哪个部分。如果它是一个命令，它可能属于 section 1。您可以阅读该命令的手册页man 查看不同部分的说明及其相应编号。

2. 将您的手册页复制到/usr/local/share/man/man1/（1如果需要，请更改为您的部分编号）。您也可以将其安装到/usr/share/man/man1/，但最佳做法是将local目录用于不使用 APT 包管理器安装的文件：

   sudo cp examplecommand.1 /usr/local/share/man/man1/
   

3. 运行mandb命令。这将更新man的内部数据库：

   sudo mandb
   

4. 就是这样！您应该能够通过运行来查看手册页：

   man 1 examplecommand
   

参考：

• 命令的联机帮助页man
• 命令的联机帮助页mandb
• /usr/bin/dh_installman如果您可以阅读 Perl 中的源代码，则随debhelper包一起安装。

Answer 2

如果您只需要在本地安装手册页：

如果MANPATH未设置，或包含一个空组件（即以 开头:、以 结尾:或包含::），<path>/share/man则将自动搜索手册页，无论何时<path>/bin是 的一部分PATH，对于 的所有值<path>。

这提供了一种为本地安装的软件添加手册页的非常简单的方法。man manpathand 中有一些细节/etc/manpath.config，但我没有看到任何提到从<path>/binto的通用映射<path>/share/man。