On Wed, Nov 18, 2009 at 10:40 PM, Nanako Shiraishi <nanako3@xxxxxxxxxxx> wrote: > Quoting Tim Henigan <tim.henigan@xxxxxxxxx> > >> 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 -- To unsubscribe from this list: send the line "unsubscribe git" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html