Re: [PATCH] Add --info-path and --man-path options to git.

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Junio C Hamano wrote:

> Where is your unhappiness coming from?  Is this your argument?
>
>	'git help' allows distros' oversight with its -m and -i options;
>	it discourages distros to get their act together.

No, my discomfort was not on behalf of distros.  It wouldn't do
anything to help or hurt distros, since they would be installing to
/usr/share/man.

When I said "installers' mistakes", I specifically meant the user that
installs manual pages to ~/share/man without setting MANPATH to
include that.  I agreed that that's an unfortunate thing to happen to
anybody, but I didn't think git is the right place to fix it.  Because
it affects anyone else installing something to $HOME, and as a user I
wouldn't _expect_ git to fix it.

What my analysis was missing is that this is not only about the user
who runs "git help -m" as a fancy way of running "man git" and expects
it to work better (who I still have no sympathy for).  It is much more
about the user who runs

	git add --help

or chooses Help â Manual in her porcelain, who certainly deserves some
documentation whether her MANPATH is set correctly or not.

I also should have remembered v1.5.4-rc0~54 (Let git-help prefer
man-pages installed with this version of git, 2007-12-06), which is
about showing the manual in /opt/git-next/man in preference to a stale
manpage from /opt/git-master/man when running
"/opt/git-next/bin/git add --help".

So I was very confused indeed.  Sorry to waste your time, and thanks
for setting me straight.
--
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


[Index of Archives]     [Linux Kernel Development]     [Gcc Help]     [IETF Annouce]     [DCCP]     [Netdev]     [Networking]     [Security]     [V4L]     [Bugtraq]     [Yosemite]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Linux SCSI]     [Fedora Users]