At 2008-07-29 16:20:00 -0700, gitster@pobox.com wrote:
The synopsis talks about the ability for you to specify zero or more
of whatever is called <refspec>, and here we define what _A_ refspec
is.
Yes. The thing is, many places say "<refspec>..." both in the synopsis
and in the description (e.g. add, am, apply, commit...), and doing it
differently in some places seems more likely to be confusing than not.
I think it's nice if items in the description exactly match something
in the synopsis. It gives me more confidence that someone didn't just
forget to update one or the other.
(If you've queued the original git-push.txt patch, I'm happy to leave
the others alone, or change them one way or another, as you wish.)
-- ams