Re: [PATCH] Make it clear that push can take multiple refspecs
- From
- Abhijit Menon-Sen <ams@toroid.org>
- Date
- Jul 30, 2008, 06:17 UTC
- Message-ID
- <20080730061727.GA1912@toroid.org>
- In-Reply-To
- <7vwsj49t27.fsf@gitster.siamese.dyndns.org>
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