From: Junio C Hamano <gitster@pobox.com>
Date: Wed, 12 Aug 2009 20:31:00 GMT
Subject: Re: [PATCH] Re: [TRIVIAL] Documentation: merge: one <remote> is required
Message-ID: <7vhbwcydtn.fsf@alter.siamese.dyndns.org>
In-Reply-To: <1250074578.7545.2.camel@localhost.localdomain>

Paul Bolle <pebolle@tiscali.nl> writes:

> Confusingly, as far as I can see, the manpages of the following commands
> seem to use the "one or more" meaning:
>     git merge-base
> ...
> ("git mv" uses both meanings in its synopsis. The two "git tag"
> invocations seem to do nothing with zero arguments and do not return an
> error.)
>
> If the above commands really use the "one or more" meaning, that would
> mean both versions are used in the documentation. I'd say it would be
> better to stick to one meaning throughout the manpages.

You are absolutely right.  We would want consistency.

I do not have any objection to make sure that we uniformly use ellipses
for one-or-more (and enclose them in [] if we want zero-or-more).  Are
these two that your patch touched the only ones that need fixing?