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
