From: Jeff King <peff@peff.net>
Date: Fri, 01 Sep 2017 22:03:23 GMT
Subject: Re: [PATCH] doc/for-each-ref: explicitly specify option names
Message-ID: <20170901220322.stzgclld56r5lbt3@sigill.intra.peff.net>
In-Reply-To: <20170901144931.26114-1-me@ikke.info>

On Fri, Sep 01, 2017 at 04:49:31PM +0200, Kevin Daudt wrote:

> For count, sort and format, only the argument names were listed under
> OPTIONS, not the option names.
> 
> Add the option names to make it clear the options exist

Yeah, this looks much better. I could see having a general "<format>"
section if it was used as the argument to multiple options, but that's
not what's going on here. And even if it were, the right thing is to
have individual "--foo=<format>" and "--bar=<format>" items in the list,
and let them refer to a more general section on formats.

-Peff