doc: git-push: clarify intro

From user feedback, 5 users are unsure what "ref" and/or "objects" means
in this context. 3 users said they don't know what "complete the refs"
means.

Many users also commented that receive hooks do not seem like the most
important thing to know about `git push`, and that this information
should not be the second sentence in the man page.

Use more familiar language to make it more accessible to users who do
not know what a "ref" is and move the "hooks" comment to the end.

Signed-off-by: Julia Evans <julia@jvns.ca>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
seen
Julia Evans 2025-10-06 18:58:47 +00:00 committed by Junio C Hamano
parent 92c87bdc40
commit 5b696cb390
1 changed files with 7 additions and 6 deletions

View File

@ -19,12 +19,9 @@ SYNOPSIS
DESCRIPTION DESCRIPTION
----------- -----------


Updates remote refs using local refs, while sending objects Updates one or more branches, tags, or other references in a remote
necessary to complete the given refs. repository from your local repository, and sends all necessary data

that isn't already on the remote.
You can make interesting things happen to a repository
every time you push into it, by setting up 'hooks' there. See
documentation for linkgit:git-receive-pack[1].


When the command line does not specify where to push with the When the command line does not specify where to push with the
`<repository>` argument, `branch.*.remote` configuration for the `<repository>` argument, `branch.*.remote` configuration for the
@ -44,6 +41,10 @@ corresponding upstream branch, but as a safety measure, the push is
aborted if the upstream branch does not have the same name as the aborted if the upstream branch does not have the same name as the
local one. local one.


You can make interesting things happen to a repository
every time you push into it, by setting up 'hooks' there. See
documentation for linkgit:git-receive-pack[1].



OPTIONS[[OPTIONS]] OPTIONS[[OPTIONS]]
------------------ ------------------