帮助文档中的 []、<>、- 和 -- 是什么意思?

What do the [], <>, - and -- mean in the help docs?

帮助文档中的[]<>---是什么意思?

当我使用git时,我可以使用git help来显示命令的用法,但我不太确定我是否理解这些符号:

$ git help 
usage: git [--version] [--help] [-C <path>] [-c name=value]
           [--exec-path[=<path>]] [--html-path] [--man-path] [--info-path]
           [-p | --paginate | --no-pager] [--no-replace-objects] [--bare]
           [--git-dir=<path>] [--work-tree=<path>] [--namespace=<name>]
           <command> [<args>]

编辑

---有区别吗?

[]表示可选

---其实就是要写在选项的前面。一些选项以 - 开头,一些选项以双 -- 开头,坚持为您需要的选项编写的选项。

<> 代表一些占位符被你需要的替换。 (例如 <path> 应该被该选项的一些相关文件的实际路径替换)

[A | B]表示可以选择A或B


注意:它与许多 Unix / Linux 命令行实用程序 "usage help" 的语法非常相似。你可以看看 https://linux.die.net/man/7/man-pages,感谢@tripleee 的 link。


从历史上看,有些选项只有一个破折号 - 而有些选项有两个破折号的原因有多种。通常,"One-dash" 用于仅使用 一个字母 的选项。但有时比这更复杂。