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

[Sebastian Pipping <sping@gentoo.org>]

On 06/26/2011 05:46 AM, William Hubbs wrote:
> I need to appologise for the last comment I made in my previous message
> about you not discussing this issue. I see that you did mention it, but
> it was before I came on board.
> 
> http://archives.gentoo.org/gentoo-catalyst/msg_78cd6eae401bfa7a499418bc6cbc225e.xml
> 
> I hope you will accept my appology.

Yes, no problem.


> However, I would still like to know why this conversion was needed;

To increase the fun maintaining it for present and future.
Run "make && man ./files/catalyst.1" to see how much better it looks now
than a few days ago.  I wouldn't have spent time on improving it at
*roff level.


> all
> we had to do was update the manpage. The conversion does make it more
> difficult for us to generate reproducable tarballs, which means that for
> gentoo's qa policy someone always has to keep the tarball we use in
> their dev space and we have to point to that tarball with SRC_URI.

I'm not following.  We have to keep the tarball on mirrors anyway.  Not?

No generated files means maintaining some things at several places.
Without the generator, mips2 and mipsel2 would still be listed on
catalyst's webpage.


> But, that would not be necessary if we generate the tarball from the git
> repo e.g. the way openrc does.

Alright.  I don't want to limit myself to a static man page (or live
with generated files under version control).

Best,



Sebastian