help: use "man.<tool>.cmd" as custom man viewer command
authorChristian Couder <chriscool@tuxfamily.org>
Fri, 25 Apr 2008 06:24:58 +0000 (08:24 +0200)
committerJunio C Hamano <gitster@pobox.com>
Sat, 26 Apr 2008 21:33:56 +0000 (14:33 -0700)
commita26a06afed783cb7cf7207c1bcb2d1781d623d1e
treec8779910127dad15ee8842f2387261a5b630565e
parent7e8114c0683e6ecfd400a5a798ae7e2fc91249fb
help: use "man.<tool>.cmd" as custom man viewer command

Currently "git help -m GITCMD" is restricted to a set of man viewers
defined at compile time. You can subvert the "man.<tool>.path" to
force "git help -m" to use a different man, viewer, but if you have a
man viewer whose invocation syntax does not match one of the current
tools then you would have to write a wrapper script for it.

This patch adds a git config variable "man.<tool>.cmd" which allows a
more flexible man viewer choice.

If you run "git help -m GITCMD" with the "man.viewer" config variable
set to an unrecognized tool then it will query the "man.<tool>.cmd"
config variable. If this variable exists, then the specified tool will
be treated as a custom man viewer and it will be run in a shell with
the man page name of the GITCMD added as extra parameter.

Signed-off-by: Christian Couder <chriscool@tuxfamily.org>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
help.c