tpope/vim-fugitive

Fugitive help inconsistent with usage of `[]` and `{}`

emiel opened this issue · 0 comments

While reading the Vim fugitive help I stumbled upon the :G and :Git commands first. See:

:G [args] Same as :Git, but two characters shorter.
*:Git*
:Git {args} Run an arbitrary git command and display any output.

If :G is the same as :Git why would there be a difference between optional and required args. If my reading of https://vimhelp.org/intro.txt.html#notation is correct then [] is optional and {} means required.

I started preparing a patch but later saw [:Git (with no arguments)](

:Git With no arguments, bring up a summary window vaguely
) and decided to just report this here. I suggest moving this :Git (with no arguments) closer to the top (near :G and :Git) or simply combine them.

Perhaps review other usages as well.