From: Adrien Beau Date: Wed, 28 Dec 2005 16:51:37 GMT Subject: Re: [ANNOUNCE] GIT preformatted documentation available. Message-ID: <94fc236b0512280851n797ecbedjecae3f8131b84369@mail.gmail.com> In-Reply-To: <7vu0cuc4c2.fsf@assigned-by-dhcp.cox.net> On 12/27/05, Junio C Hamano wrote: > > I was asked to provide pre-formatted man pages (and perhaps html > pages), since the time of kernel developers are better spent on > what they do best, rather than preparing the xmlto toolchain. > > I was planning to do a tarball every time I do a "release", but > that would mean it is no better than the current way --- you > could extract manpages out of rpm anyway. > > So instead, I'll do independent branches "html" and "man" in > git.git repository to keep the preformatted documentation. Having preformatted documentation is a great step forward, but it would be even better if we could have it without installing some weird RPM tool or a local copy of the Git repository -- not all my machines have that. Besides, it's not very beginner- or newcomer-friendly. Grab the source; discover you need a complex toolchain to have manpages; maybe learn sometime later that "all you had to do" was get an RPM and explode some parts of it -- nah, it just doesn't feel right. You're already generating five RPMs and two tarballs everytime you release a version, would it be much more taxing to generate a third tarball? That said, those two new branches are neat. Thanks!