From: Luciano Miguel Ferreira Rocha Date: Tue, 14 Apr 2009 13:14:24 GMT Subject: Re: making docs Message-ID: <20090414131424.GB16419@bit.office.eurotux.com> In-Reply-To: <49E4A72D.21604.198A9AD@Ulrich.Windl.rkdvmks1.ngate.uni-regensburg.de> On Tue, Apr 14, 2009 at 03:09:33PM +0200, Ulrich Windl wrote: > Hi! > > THis is a change request: When building Git, many systems lack the tools to build > the documentation, so the Manual pages (among others) are not built. When > installing, several ".txt" files are installed, but when invoking help like "git > commit --help", git only complains about not finding the manual page. > > Obvious solutions are: > 1) Pre-build the documentation (manual pages) with the source archive. If the > sources are used unmodified, the manual pages should be fine > 2) If nothing better is found when invoking help, display the text files with a > pager > > An alternative to 1) would be a add-on "source" package that contains the pre- > built documentation. Documentation files should be platform-independent, so that > should be fine for almost everyone. > > Comments? If using the git repository, there's the man branch with prebuilt man pages. There's already the 'add-on "source" package', e.g. http://www.kernel.org/pub/software/scm/git/git-manpages-1.6.2.3.tar.bz2 Regards, Luciano Rocha -- Luciano Rocha Eurotux Informática, S.A.