Re: Suggestion: "man git clone"

From: Jeff King <peff@peff.net>
Date: Aug 21, 2008, 20:18 UTC
Message-ID: <20080821201828.GA28844@coredump.intra.peff.net>
In-Reply-To: <48ADCCB1.6040803@zytor.com>

On Thu, Aug 21, 2008 at 01:14:41PM -0700, H. Peter Anvin wrote:

Show 5 quoted lines

>> Ah, OK. My problem was that the pages actually need to be named "am.git",
>> etc. But with 'git' in the section field, "man git am" does work.
>> Unfortunately, it seems to break "man git". :(
>
> Yeah, that pretty much makes it not a general solution.

Oh, sorry, this was just me being incompetent. I was testing with

  MANSECT=git man git am

and of course

  MANSECT=git man git

broke because we are no longer looking in section "1".

Setting the sections properly (by adding "git" to /etc/manpath.config, or using MANSECT=1:git) and creating a linkfarm in .../man/mangit (with am.git pointing to ../man1/git-am.1) makes both "man git" and "man git am" work fine.

The changes to manpath.config make it a bit outside the scope of git's regular install, but maybe this is something distro people would want to do.

-Peff