[PATCH 0/4] builtin/refs: add ability to write references
- From
Patrick Steinhardt <ps@pks.im>
- Date
- Jun 16, 2026, 08:44 UTC
- Message-ID
- <20260616-pks-refs-writing-subcommands-v1-0-9f5219b6109d@pks.im>
Hi,
Reference-related functionality in Git is currently spread across many different commands: git-update-ref(1), git-for-each-ref(1), git-show-ref(1), git-pack-refs(1) and git-symbolic-ref(1). This makes it hard for users to discover what functionality we have available to work with references.
We have thus started to consolidate this functionality into git-refs(1), which is a toolbox of everything related to references. Until now, the command doesn't handle functionality of git-update-ref(1).
This patch series backfills most of the functionality by introducing three new commands:
- `git refs delete` to delete references. This is the equivalent of
`git update-ref -d`. - `git refs update` to update references. This is the equivalent of
`git update-ref <refname> <oldvalue> <newvalue>`. - `git refs rename` to rename a reference, including its reflog. This
does not have an equivalent in git-update-ref(1), but is inspired by
and supersedes [1].Thanks!
Patrick
[1]: <xmqqv7brz9ba.fsf@gitster.g>
---
Patrick Steinhardt (4):
builtin/refs: drop `the_repository`
builtin/refs: add "delete" subcommand
builtin/refs: add "update" subcommand
builtin/refs: add "rename" subcommandDocumentation/git-refs.adoc | 34 +++++++++ builtin/refs.c | 153 +++++++++++++++++++++++++++++++++++-- t/meson.build | 3 + t/t1464-refs-delete.sh | 133 ++++++++++++++++++++++++++++++++ t/t1465-refs-update.sh | 179 ++++++++++++++++++++++++++++++++++++++++++++ t/t1466-refs-rename.sh | 131 ++++++++++++++++++++++++++++++++ 6 files changed, 625 insertions(+), 8 deletions(-)
--- base-commit: 700432b2ba22603a0bcb71475c9c333d17c9b0d1 change-id: 20260616-pks-refs-writing-subcommands-7a77be5bda9b