Re: git help -t <topic>: list the help of the commands in a given topic

[Junio C Hamano <gitster@pobox.com>]

Santi Béjar <sbejar@gmail.com> writes:

> With 'git help -t' lists the available topics.
>
> Show a hint to get a longer list when listing the common commands.

I like the idea of making the categorized command list in git(7)
available, and agree with you that renaming common_cmds[] to cmd_list[]
and place everything in there would be the way to go.

However, I doubt about your presentation.  Who are the intended
audience and what is the expected way this is used?

I highly suspect that it would be much easier to use if you add a mode
to "git help" that runs the pager over the categoized command list part
of git(7) manual page, without taking "show me list of topics" nor "show
commands only in this topic" parameters.  It is highly unlikely that a
user knows which category an obscure command whose name he wants to
recall is in, or can guess which category it would be classified in
after seeing the "category list".  It would be much more likely that he
finds it easier to scan (perhaps with "/<string>") the command list with
one line description in the pager.