doc: git-push: add explanation of `git push origin main`

Git fork

What happens if you run `git push` without any arguments is actually
extremely complex to explain, as discussed in the previous commit.

But it's very easy to explain what `git push <remote> <branch>` does, so
start the man page by explaining what that does.

The hope is that someone could just stop reading the man page here and
never learn anything else about `git push`, and that would be fine.

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

authored by

Julia Evans and committed by

Junio C Hamano 5 months ago a72504fe 6e1688f1

1 changed file

expand all

Documentation

git-push.adoc

Documentation/git-push.adoc

··· 23 23 repository from your local repository, and sends all necessary data 24 24 that isn't already on the remote. 25 25 26 + The simplest way to push is `git push <remote> <branch>`. 27 + `git push origin main` will push the local `main` branch to the `main` 28 + branch on the remote named `origin`. 29 + 26 30 The `<repository>` argument defaults to the upstream for the current branch, 27 31 or `origin` if there's no configured upstream. 28 32