如何为deb包创建手动输入

Question

创建deb包时,我在哪里编写手册？是否有任何格式规则/最佳实践要尊重？

我对deb包的创建很新.在一些教程之后,我刚刚创建了一个安装/执行良好的软件包,所以现在我想编写一些文档,以便man myFancyPackage返回一些内容,而不是myFancyPackage的手动输入.

不幸的是,我找到的所有教程都没有谈到手动创建.

Answer 1

有很多方法可以构建Debian软件包,但目前的"最佳实践"是使用Debhelper提供的工具.在手册页的情况下,有一个名为dh_installman(读取其手册页)的工具会被自动调用dh.如果您使用dh_make或类似地为您的包创建模板,那么dh将在您的debian/rules文件中进行调用.

dh_installman通过阅读文件来工作debian/manpages,或debian/nameofyourpackage.manpages.此文件包含指向程序包手册页的路径列表.路径相对于包的根目录.这里有一个真实包的例子.然后,此程序将正确安装您的手册页在正确的目录中.

因此,总而言之,您只需创建debian/package.manpages并填充手册页的路径即可.这些路径必须相对于包的根目录.如果您(打包者)正在编写手册页,则必须将它们放在Debian/目录中.