]> git.ipfire.org Git - thirdparty/git.git/commit
doc txt & -h consistency: add missing options and labels
authorÆvar Arnfjörð Bjarmason <avarab@gmail.com>
Thu, 13 Oct 2022 15:39:13 +0000 (17:39 +0200)
committerJunio C Hamano <gitster@pobox.com>
Thu, 13 Oct 2022 16:32:56 +0000 (09:32 -0700)
commit8c9e292dc091e637eeb78fb0046c3572717b4a67
treede4d63e2e6934fe3a2e1b20529554bdd0c184865
parent8f5f2f646a07772df12c3f7bf17eb62541042e41
doc txt & -h consistency: add missing options and labels

Fix various issues of SYNOPSIS and -h output syntax where:

 * Options such as --force were missing entirely
 * ...or the short option, such as -f

 * We said "opts" or "options", but could instead enumerate
   the (small) set of supported options

 * Options that were missing entirely (ls-remote's --sort=<key>)

   As we can specify "--sort" multiple times (it's backed by a
   string-list" it should really be "[(--sort=<key>)...]", which is
   what "git for-each-ref" lists it as, but let's leave that issue for
   a subsequent cleanup, and stop at making these consistent. Other
   "ref-filter.h" users share the same issue, e.g. "git-branch.txt".

 * For "verify-tag" and "verify-commit" we were missing the "--raw"
   option.

Signed-off-by: Ævar Arnfjörð Bjarmason <avarab@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
19 files changed:
Documentation/git-send-pack.txt
Documentation/git-sparse-checkout.txt
Documentation/git-update-server-info.txt
Documentation/git-verify-commit.txt
Documentation/git-verify-tag.txt
builtin/credential-cache--daemon.c
builtin/describe.c
builtin/diff-index.c
builtin/ls-remote.c
builtin/pack-refs.c
builtin/revert.c
builtin/send-pack.c
builtin/symbolic-ref.c
builtin/tag.c
builtin/update-server-info.c
builtin/upload-pack.c
builtin/verify-commit.c
builtin/verify-tag.c
help.c