命令行选项文档的标准

Question

我经常破解一些Thor，Rake，Bash甚至PHP命令行工具。我想以一致的方式记录命令行参数和变体。

本文档是否有官方标准或推荐标准？

就像当一个选项是可选的[--foo=bar]，或者当一个选项可以是一个n值（"yes|no"）时，等等。

我宁愿不提出自己的标准，当有一个官方（POSIX？）标准或指南已经列出了在CLI上记录工具和应用程序的注意事项时。

Answer 1

我不确定您想到的输出格式是什么，但为什么不使用手册页样式呢？它似乎非常适合命令行工具。