在我看来,对于如何为最终用户编写描述命令使用的概要,每个人都有自己的想法。
例如,这是来自的格式man grep
:
grep [OPTIONS] PATTERN [FILE...]
grep [OPTIONS] [-e PATTERN | -f FILE] [FILE...]
Run Code Online (Sandbox Code Playgroud)
现在这有一些出现在其他联机帮助页中的语法。 []
被认为是可选的,并且...
作为相同输入的倍数有意义。
但是人们使用|
or/
为 OR ,还有其他人会颠倒什么[]
意思。或者他们没有给出任何关于去哪里的迹象[OPTIONS]
。
我想遵循我写的东西的标准,但我看到的每个网站都会告诉我一些不同的东西。
是否有编写概要的实际标准方式,或者惯例只是人们一直在做的事情?