Re: [ANNOUNCE] Guilt v0.31

From: Michael J Gruber
Date: Tue Sep 09 2008 - 06:10:37 EST


Junio C Hamano venit, vidit, dixit 08.09.2008 21:17:
> "Bert Wesarg" <bert.wesarg@xxxxxxxxxxxxxx> writes:
>
>> I must admit, that I don't like these extra tarballs with docs. I
>> always expect, that the manpages are nicely installed if I type 'make
>> install' (or at least with a install-doc target). But I need to
>> download this extra package, and extract it to the right place, there
>> is no Makefile whatsoever. In case of git its really annoying, because
>> the help mechanism is relying on the manpages (i.e. git help <cmd> or
>> git <cmd> --help, but you know this).
>
> There is no need to feel "it[']s really annoying", as install-doc from the
> tarball distribution works out of the box.
>
> I used 1.6.0.1 in the demonstration below, but this is nothing new in that
> version but has been like this for quite some time (it is how sample RPMs
> binary packages are built, so the procedure ought to work):
>
> $ ls -1 /usr/bin/git ;# to show there is no other "git" on this box
> ls: /usr/bin/git: No such file or directory
> $ mkdir /var/tmp/16
> $ cd /var/tmp/16
> $ wget http://www.kernel.org/pub/software/scm/git/git-1.6.0.1.tar.gz
> $ tar xf git-1.6.0.1.tar.gz
> $ cd git-1.6.0.1
> $ make prefix=/var/tmp/16test install install-doc
> $ PATH=/var/tmp/16test/bin:/usr/bin:/bin
> $ export PATH
> $ unset MANPATH
> $ git help cat-file | cat -s | tail -n 8
> Reformatting git-cat-file(1), please wait...
> DOCUMENTATION
> Documentation by David Greaves, Junio C Hamano and the git-list
> <git@xxxxxxxxxxxxxxx>.
>
> GIT
> Part of the git(1) suite
>
> Git 1.6.0.1 09/08/2008 GIT-CAT-FILE(1)
>

This works because you have the full toolchain, especially xmlto.
asciidoc'ing directly to man (bypassing xmlto) may help some of us.

> The extra tarballs for documentation are also given as courtesy because
> they are supposed to be platform independent and some people do not want
> to generate them themselves (even though they could).
>
> Either be thankful for the availability of tarballs, or ignore them and
> generate them yourself --- it's your choice.

He might want an install target which installs doc from the doc-tarball
or from the man- and html-branches. Be it a Makefile in those
convenience branches. I know it's just a tar or cpio away, of course. I
might look at a Makefile for the doc branches.

Michael
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/