From: Patrick Steinhardt Date: Thu, 01 Oct 2026 10:13:27 GMT Subject: [PATCH 0/3] builtin/refs: introduce subcommand groups Message-ID: <20261001-b4-pks-parse-options-subcommand-groups-v1-0-01eb2f4a4c32@pks.im> Hi, the git-refs(1) command has grown quite a bunch of different subcommands by now. These subcommands can easily be grouped into three categories: - Operations that span across the whole reference database (migrate, verify, optimize). - Operations that read references (list, exists). - Operations that write references (create, delete, update, rename). This patch series thus adapts the parse-options subsystem to support grouping subcommands and then introduces the grouping for git-refs(1). This results in the following output: usage: git refs migrate --ref-format= [--no-reflog] [--dry-run] or: git refs verify [--strict] [--verbose] or: git refs list [--count=] [--shell|--perl|--python|--tcl] [(--sort=)...] [--format=] [--include-root-refs] [--points-at=] [--merged[=]] [--no-merged[=]] [--contains[=]] [--no-contains[=]] [(--exclude=)...] [--start-after=] [ --stdin | (...)] or: git refs exists or: git refs optimize [--all] [--no-prune] [--auto] [--include ] [--exclude ] or: git refs create [--message=] [--no-deref] [--create-reflog] or: git refs delete [--message=] [--no-deref] [] or: git refs update [--message=] [--no-deref] [--create-reflog] [] or: git refs rename [--message=] Reference database migrate migrate the reference database to a different format verify verify the consistency of the reference database optimize optimize the reference database Reading references list list references exists check whether a reference exists Writing references create create a new reference delete delete a reference update update an existing reference rename rename a reference I expect that going forward, we'll probably have more use cases where we can use these new capabilities (e.g. an upcoming git-objects(1) command, which is going to be the equivalent to git-refs(1)). Thanks! Patrick --- Patrick Steinhardt (3): parse-options: fix completion format when first option is skipped parse-options: allow grouping subcommands builtin/refs: introduce subcommand groups Documentation/git-refs.adoc | 2 +- Documentation/technical/api-parse-options.adoc | 10 ++++- builtin/refs.c | 32 ++++++++----- parse-options.c | 62 ++++++++++++++------------ parse-options.h | 7 +++ t/helper/test-parse-options.c | 4 +- t/t0040-parse-options.sh | 16 +++++++ 7 files changed, 92 insertions(+), 41 deletions(-) --- base-commit: a018953688f1b10bddf91bff8747068f5f4746a4 change-id: 20261001-b4-pks-parse-options-subcommand-groups-59b3f27da06c