[PATCH] git-push.txt: describe how to default to pushing only current branch
From: Chris Johnsen <hidden>
Date: 2016-06-15 22:46:23
Subsystem:
documentation, the rest · Maintainers:
Jonathan Corbet, Linus Torvalds
--- Jeff King [off-list ref] writes:
git config remote.$remote.push HEAD It isn't mentioned in the git-push manpage; maybe a documentation patch to give an example using HEAD would make sense?
Here is a patch. It also attempts to document bare 'git push'. In the resulting manpage the inline commands are not very obvious (the HTML looks OK though). There is some sort of formatting in there, but it does not seem to display any differently from the surrounding text when I use man to view it on my system. Would it be better to do something like wrap double quotes around the inline commands to help readers viewing the manpage? --- Documentation/git-push.txt | 26 ++++++++++++++++++++++++-- 1 files changed, 24 insertions(+), 2 deletions(-)
diff --git a/Documentation/git-push.txt b/Documentation/git-push.txt
index 4e7e5a7..fd53c49 100644
--- a/Documentation/git-push.txt
+++ b/Documentation/git-push.txt@@ -24,8 +24,8 @@ every time you push into it, by setting up 'hooks' there. See documentation for linkgit:git-receive-pack[1]. -OPTIONS -------- +OPTIONS[[OPTIONS]] +------------------ <repository>:: The "remote" repository that is destination of a push operation. This parameter can be either a URL
@@ -187,6 +187,28 @@ reason:: Examples -------- +git push:: + Works like `git push <remote>`, where <remote> is the + current branch's remote (or `origin`, if no remote is + configured for the current branch). + +git push origin:: + Without additional configuration, works like + `git push origin :`. ++ +The default behavior of this command when no <refspec> is given can be +configured by setting the `push` option of the remote. ++ +For example, to default to pushing only the current branch to `origin` +use `git config remote.origin.push HEAD`. Any valid <refspec> (like +the ones in the examples below) can be configured as the default for +`git push origin`. + +git push origin ::: + Push "matching" branches to `origin`. See + <refspec> in the <<OPTIONS,OPTIONS>> section above for a + description of "matching" branches. + git push origin master:: Find a ref that matches `master` in the source repository (most likely, it would find `refs/heads/master`), and update
--
1.6.2