Re: [gentoo-catalyst] Migrating man page to asciidoc?

[William Hubbs <williamh@gentoo.org>]

[-- Attachment #1: Type: text/plain, Size: 1491 bytes --]

On Sun, Jun 26, 2011 at 05:14:38AM +0200, Sebastian Pipping wrote:
> On 06/26/2011 04:49 AM, William Hubbs wrote:
> > No, we can't have the manpage pre-rendered in the tarball, because that
> > makes the tarball different every time it is created since the
> > date/timestamps in the archive will be different. In other words, it is
> > not possible for anyone to ever reproduce the exact same tarball that we
> > produce.
> 
> The varience in timestamp has been no problem for other projects
> including genkernel.  If all that varies is the time stamp and it
> matters to you, it would be easy to add a section to the Makefile
> setting the timestamp to a hardcoded value.

That is already done if you use "git archive" to generate the archive
and use the tags in the git repository along with that. For an example,
look at openrc's git repository.
> > I see two ways around this: We can either make asciidoc a build time
> > dependency so that the user can use something like "make manpage" to
> > generate the manpage
> 
> That adds quite some load on indirect dependencies for more or less
> nothing, as seen with Matt earlier.

That is exactly why I prefer the other option I mention below.

> > or we can go back to the manpage that is in the git
> > repository.
> 
> Do I have to list reasons against this option?

I think it would be helpful if you did since you did the conversion
without discussing it with the rest of the team first.

William


[-- Attachment #2: Type: application/pgp-signature, Size: 198 bytes --]