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

[Sebastian Pipping <sping@gentoo.org>]

On 06/26/2011 05:36 AM, William Hubbs wrote:
> 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'm aware of git archive - it does not support handling of generated
files afaik.


>>> 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.

Alright.  On the other hand without dependencies you get nowhere: either
you don#t have features or you build every wheel yourself.


>>> 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.

Peter Volkov voted for it, Peter Stuge said the list was rather silent.
 So I went for it.  The migration in genkernel was of great help.  I see
your apology in your other mail now, accepting.

Benefits of the current Asciidoc approach:

 - No need to write *roff manually.
   Plus Asciidoc syntax is more readable.

 - Man page keeps itself in sync on

   - list of subarches

   - version of catalyst

 - Option to make XHTML from the same source

Best,



Sebastian