如何手动安装手册页?

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

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

  1. 首先,找出您的手册页属于哪个部分。 如果是命令,它可能属于第1部分。 您可以阅读man命令的联机帮助页 Manpage图标 查看不同部分的描述及其相应的编号。

  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命令的联机帮助页 Manpage图标
  • mandb命令的联机帮助页 Manpage图标
  • /usr/bin/dh_installman的源代码,如果你可以读取与debhelper包一起安装的Perl。

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

如果取消设置MANPATH ,或者包含一个空组件(即以:开头,以:结束,或者包含:: ,那么每当/bin是其中一部分时, /share/man将自动搜索手册页。 PATH用于所有值

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