是否有命名和放置源树中命令的手册页文件的约定？

Question

我认为该名称可以采用格式

<command_name>.<section_number>

其中数字显示在 的描述章节中man man。

我用文档存储库中文件的目录。

Answer 1

鉴于您的手册页是从其他“源文件”生成的，我根本不会将其存储在存储库中 - 根据我的经验，源存储库最好只存储您实际上想要直接修改的文件，不是生成的文件。

如果您确实想存储它（例如，为了避免help2man在构建时需要），由于您没有目录结构，因此可以将其与其余源文件一起存储。您建议的命名方案<command_name>.<section_number>很好。