From: Junio C Hamano <gitster@pobox.com>
Date: Sat, 03 May 2008 17:44:57 GMT
Subject: Re: [PATCH 3/3] Documentation: convert tutorials to man pages
Message-ID: <7vfxszuvs6.fsf@gitster.siamese.dyndns.org>
In-Reply-To: <200805030604.32123.chriscool@tuxfamily.org>

Christian Couder <chriscool@tuxfamily.org> writes:

> About man page sections, Perl is consistent because every thing is in 
> section 1.

I do not think it is a good example to follow, though.

> Now for git we already have git commands in section 1 and some 
> other documentation (gitattributes, gitignore, gitmodules) in section 5 
> and "git" in section 7. Do we want to keep "git" alone in section 7 and put 
> tutorials in section 1 ? Or put everything in section 1 ?

My preference is to move git(7) to git(1) because it is describing a
command at the end-user level (distros are much better than us to come up
with a way to deal with conflict resolution between us and the other git),
keep file format description in section 5 (that's where they belong to).