From: Christian Couder <chriscool@tuxfamily.org>
Date: Tue, 29 Apr 2008 05:18:47 GMT
Subject: Re: [PATCH] git-help: Try to find html pages without the git- prefix
Message-ID: <200804290718.47961.chriscool@tuxfamily.org>
In-Reply-To: <7vy76x8e0s.fsf@gitster.siamese.dyndns.org>

Le mardi 29 avril 2008, Junio C Hamano a écrit :
> Christian Couder <chriscool@tuxfamily.org> writes:
> > We already have the following files following that scheme:
> >
> > gitk.txt
> > gitattributes.txt
> > gitignore.txt
> > gitcli.txt
> > gitmodules.txt
> > git.txt
> >
> > And for example the following commands are already working:
> >
> > $ git help -w gitmodules
> > $ git help -m gitmodules
> > $ man gitmodules
>
> That is not surprise as gitattributes(5), gitignore(5) and gitmodules(5)
> work by design.  They are valid manual pages in section 5 (file formats).
>
> I am not sure about hooks let alone gitcli --- they are not something you
> would traditionally place in section 5.

Aren't there other man sections where we could put them ?

> It would be nice if "git help <any path you see in Documentation/>"
> worked as expected, 

I agree and that means that we should find an appropriate man section for 
everything in "Documentation/". Otherwise how could "git help -m <any path 
you see in Documentation/>" work ?

Thanks,
Christian.

> although I personally tend to go to the *.txt files 
> ;-)