Re: [ANNOUNCE] Guilt v0.31

["Bert Wesarg" <bert.wesarg@googlemail.com>]

On Mon, Sep 8, 2008 at 20:43, Josef 'Jeff' Sipek <jeffpc@josefsipek.net> wrote:
> On Mon, Sep 08, 2008 at 08:33:23PM +0200, Bert Wesarg wrote:
>> Hi,
>>
>> On Mon, Sep 8, 2008 at 15:52, Josef 'Jeff' Sipek <jeffpc@josefsipek.net> wrote:
>> > Guilt v0.31 is available for download.
>>
>> Is it possible to include pre-generated docs in the tarballs?
>>
>> I downloaded one and run 'make doc' and get these messages:
>>
>> fatal: Not a git repository
>>
>> which looks like it comes from this line in Documentation/Makefile:
>>
>> VERSION=$(shell git describe)
>>
>> Its not critical, but looks awkward.
>
> 1) I already commit generated man pages for each release - on the man branch
>   (there's also html branch with the html-formated man pages).
>
> 2) I'm aware of the git error you saw, and it is on my todo list
>
> 3) I just checked the git tarballs, and they don't include man pages either.
>   Should I include the manpages in the source tarball, or should I just
>   create another tarball with the manpages? (The git error will get fixed
>   regardless - that's the only invocation of git during the manpage build
>   process, and it's there only to get a nice looking version number to
>   include in the manpages.)
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).

Thanks
Bert
>
> Josef 'Jeff' Sipek.