[sword-devel] Man pages (was: Re: Making Import Easier)

[Jonathan Marsden]

Sebastien Koechlin wrote:

> Can we imagin having a perl script that will grab pages on the wiki
> and generate a man page for each?

Yes, I thought of this last night, too.  This would mean that those 
updating the "wiki man pages" would need to be careful to stick to a 
format that converts cleanly into man pages.  I'd very much welcome 
this, if those maintaining the wiki pages are willing to do that.

Since we are required to have man pages for Debian and Ubuntu packages 
anyway, even if they are manually maintained, I'm not convinced they 
will become obsolete all that quickly; unless the whole packaging effort 
folds, every new release of Debian/Ubuntu packages of SWORD will be a 
time to re-check the set of man pages, and update them or add new ones 
as needed.

As I see it, contributing what we have written back to the "upstream" 
project is something of a "win-win" proposition: the amount of packaging 
stuff that us packagers need to maintain is reduced (because the man 
pages are in the source tarball), and those who use the source tarball 
either directly or packaged in another form (such as RPMs) can benefit 
from the man pages, too.

Jonathan
--
Jonathan Marsden