是否有编写命令摘要的标准？

在我看来，每个人对于如何编写概要描述最终用户的命令用法都有自己的想法。

例如，这是来自的格式man grep：

grep [OPTIONS] PATTERN [FILE...]
grep [OPTIONS] [-e PATTERN | -f FILE] [FILE...]

现在，它的某些语法出现在其他手册页中。 []被认为是可选的，并且...对于同一输入的倍数有意义。

但是人们使用“ |或” /作为“或”，还有其他人会颠倒[]含义。或他们没有给出任何指示[OPTIONS]。

我想遵循我写的标准，但是我浏览的每个网站都会告诉我一些不同的东西。

有没有编写提要的实际标准方法，或者约定是人们长期以来所做的事情？

对此的经典标准来自POSIX，实用程序参数语法（感谢@illuminÉ的更新链接）。它描述了手册页中使用的语法，例如

utility_name[-a][-b][-c option_argument]
    [-d|-e][-f[option_argument]][operand...]

传统上，它建议使用单字符选项，并-W建议供供应商使用，这就是容纳多字符选项的方式（例如，参见gcc选项摘要）。

GNU软件引入了以开头的多字符选项--。在help2man参考中可以找到GNU的一些使用这些选项格式化手册页的准则。