是否有编写手册页的最佳实践指南？
布局应包含哪些内容？标准的是：
NAME
概要
说明
举例
另请参见
还有其他像 OPTIONS ， AUTHOR 。
作为用户，有什么用处？什么没用？
答案 0 :(得分：4)
如果您找不到1970年代贝尔实验室“troff”文档的旧版本，其中有一些关于编写手册的好文章，:-)那么我建议在他的网站上试用Jens的"HOWTO" on writing man pages
Unix 7th Edition手册可以多种形式在线获取。
答案 1 :(得分：1)
BUGS部分很好，EXAMPLES部分总是很有用。有些手册页包含一个 “文件”部分列出了相关的配置文件，或“环境”部分，详细说明了任何有影响的环境变量。
要明确的是，哪些部分或类型的信息对用户有用取决于您正在记录的程序或实用程序的性质。
答案 2 :(得分：1)
有一个随UNIX系统分发的规范手册页大纲，或者至少通常有。一般来说，我会放入所有字段，如果不适用，则包含“无”字样的行。
答案 3 :(得分：1)
人们有时忘记在手册页中放置的一件事是函数返回值的含义。这很容易忘记，但遗漏可能会让那些必须使用你功能的人的生活更加艰难。此外，SYNOPSIS中的一个简单代码段或一个很好的最小工作示例非常有用。
我经常对手册页做的一件事就是尝试找到一个相关的命令，即使我知道我正在看的东西不能做我想要的东西。在这种情况下，看起来也很棒。
答案 4 :(得分：0)
这取决于您的软件的功能。如果它是一个小型独立应用程序，我肯定会将AUTHOR部分放在手册页中，这样如果用户发现错误，他们就可以轻松找到一个电子邮件地址来向您报告错误。
至于最佳实践，我不知道，除了手册页应该简洁，详细但不包含太多不需要的信息，如果它只是一个工具，例如不需要内部工作