Re: [PATCH v4] git remote: Separate usage strings for subcommands

From: Tim Henigan <tim.henigan@gmail.com>
Date: Nov 19, 2009, 14:51 UTC
Message-ID: <32c343770911190651w3f1ac9b6i2d3b1a62a032489f@mail.gmail.com>
In-Reply-To: <20091119124040.6117@nanako3.lavabit.com>

On Wed, Nov 18, 2009 at 10:40 PM, Nanako Shiraishi <nanako3@lavabit.com> wrote:

Show 12 quoted lines

> Quoting Tim Henigan <tim.henigan@gmail.com>
>
>> When the usage string for a subcommand must be printed,
>> only print the information relevant to that command.
>
> I think this is a huge improvement.
>
> Often people look at this part of the manual page to quickly remind
> themselves what options are available, and it is better to keep the
> current text. Some manual pages have to use [options...] when there
> are too many to list, but each subcommand of git-remote doesn't have
> that many options.

... snip ...

> For the same reason, I don't think this is a good change, if these
> lines are used to show the first lines of 'git-remote -h' output.

The original version of this patch [1] left the contents of the usage strings intact. However, Junio expressed a preference to change them to use the generic <options>. See this thread for the discussion [2].

[1] http://article.gmane.org/gmane.comp.version-control.git/133048/ [2] http://thread.gmane.org/gmane.comp.version-control.git/132968/focus=133050