From: Chris Johnsen Date: Sat, 14 Mar 2009 01:27:31 GMT Subject: [PATCH] git-push.txt: describe how to default to pushing only current branch Message-ID: <1236994051-27346-1-git-send-email-chris_johnsen@pobox.com> In-Reply-To: <20090313164941.GA16504@sigill.intra.peff.net> --- Jeff King 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]] +------------------ :: 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 `, where 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 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 (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 + in the <> 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