[sword-devel] Man pages (was: Re: Making Import Easier)
jmarsden at fastmail.fm
Tue Apr 7 10:38:19 MST 2009
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 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.
More information about the sword-devel