Documentation/git-push: clarify the description of defaults
commitcfe1348da60b75f6093f8fb6741630b06693e57a
authorJunio C Hamano <gitster@pobox.com>
Fri, 8 Mar 2013 17:44:33 +0000 (8 09:44 -0800)
committerJunio C Hamano <gitster@pobox.com>
Fri, 8 Mar 2013 17:55:08 +0000 (8 09:55 -0800)
treec5267568473698021abd5eca6e473002dace6732
parent15999998fbda60552742275570947431b57108ae
Documentation/git-push: clarify the description of defaults

We describe what gets pushed by default when the command line does
not give any <refspec> under the bullet point of <refspec>.

It is a bit unfriendly to expect users to read on <refspec> when
they are not giving any in the first place.  "What gets pushed" is
determined by taking many factors (<refspec> argument being only one
of them) into account, and is a property of the entire command, not
an individual argument.  Also we do not describe "Where the push
goes" when the command line does not say.

Give the description on "what gets pushed to where" upfront before
explaining individual arguments and options.

Also update the description of <refspec> to say what it is, what it
is used for, before explaining what shape it takes.

Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-push.txt