]> git.ipfire.org Git - thirdparty/git.git/commit
doc: git-push: rewrite refspec specification
authorJulia Evans <julia@jvns.ca>
Tue, 23 Sep 2025 18:10:49 +0000 (18:10 +0000)
committerJunio C Hamano <gitster@pobox.com>
Wed, 24 Sep 2025 19:29:34 +0000 (12:29 -0700)
commit657586a5a6ddfa1d6c732b8b0f4670d198a4be02
treefc9fd4b32a46c9e6f482cd00593be21b8f29fb59
parentcc1cc31e2a46e33941840bbb2026fff2d0532b2b
doc: git-push: rewrite refspec specification

From user feedback, there was a request for examples, as well as a
comment that one person found "If git push [<repository>] without
any <refspec> argument is set to update some ref at the destination
with <src> with remote.<repository>.push configuration variable..."
impossible to understand.

To make the section easier to navigate, create a list of every possible
refspec form, with examples for each form as well as 2 forms which were
previously missing (patterns and negative refspecs).

Made a few changes to use more familiar language, but ultimately
refspecs are a pretty advanced feature so I've mostly left the
terminology alone.

Signed-off-by: Julia Evans <julia@jvns.ca>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-push.adoc