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

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

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.