Description of problem:

The "-h" option to "git ls-remote" is an alias for "--heads", except when "-h" is not used with any other options, in which case, a usage string is returned.

That is by design, but the man page does not say so.

$ git ls-remote -h
usage: git ls-remote [--heads] [--tags] [--refs] [--upload-pack=<exec>]
...

Compare with:

$ git ls-remote --heads

However:

$ man git-ls-remote
...
       -h, --heads, -t, --tags
           Limit to only refs/heads and refs/tags, respectively. These options are not mutually exclusive; when given both, references stored
           in refs/heads and refs/tags are displayed.
...

Version-Release number of selected component (if applicable):
git-2.17.2-2.fc28.x86_64

How reproducible:
Always.

Steps to Reproduce:
$ man git-ls-remote

Actual results:
The man page says that the "-h" option is an alias for the "--heads" option.

Expected results:
The man page should explain that when the "-h" option is not used with any other options, a usage string is returned.

Additional info:

These behave as expected:

$ git ls-remote -th
$ git ls-remote -ht

$ git ls-remote --heads
$ git ls-remote -t
$ git ls-remote --tags

Related commit:

ls-remote: a lone "-h" is asking for help
https://github.com/git/git/commit/91a640ffb6d9dd10c293a575a692d9771b6e13c7