Re: [PATCH 2/3] help: Add '--follow-alias' option

김남형 [off-list ref] writes:

2012-03-15 3:00 PM, Junio C Hamano wrote:

quoted

Namhyung Kim[off-list ref]  writes:

quoted

The --follow-alias option will look up the alias definitions and
use the first word as a command. For example, if I set my aliases
as follows:

  $ git help br
  `git br' is aliased to `git branch'
  $ git help ru
  `git ru' is aliased to `git remote update'

adding --follow-alias (or -f) option will show man pages of
git-branch and git-remote, respectively.

What would happen when somebody has this?

	[alias]
         	br = branch --list

	$ git help --follow-alias br
	... man page for git-branch is shown ...

NAK.

I'm sorry I don't understand what you meant by this. What should be
happened for this?

You _somehow_ restict the output, or at least draw the user's attention,
to the description of --list mode in the resulting "git-branch" manual.

I do not think that is feasible.

But showing the whole manual page, without telling the user that "br" is
not aliased to a plain vanilla "branch" without any option, is not a
solution, especially if you are going to let the user set a configuration
variable to allow him to forget about this setting. Progressive revelation
would not have such a downside and I think it is more appropriate approach
for something like "help".