[sword-devel] Making Import Easier

[Chris Little]

Jonathan Marsden wrote:
>> As to why the current documentation isn't better, or why there aren't
>> more modules in source format to look at, it's essentially CrossWire
>> policy to keep it so that average users can't create modules easily
> 
> In which case, any form of "Making Import Easier", whether standalone or 
> embedded into the front end reader programs, runs contra to the wishes 
> of CrossWire... so is the whole issue therefore moot in this forum 
> (sword-devel at crosswire.org) anyway??
> 
> Does this also mean I am likely to find my offering manpages for the 
> existing conversion tools turned down on the grounds that they improve 
> the usability of the tools, and such usability is explicitly unwanted!? 
>  That would be an unusual reason for declining contributed documentation.

Don't mind Matthew Talbert. He likes to flaimbait, and he really ought 
to apologize for his slander (which is furthermore slander of the false 
sort).

You're absolutely welcome to do anything and everything you're willing 
to do (even as little as complain and point our deficiencies) to aid 
module creation in any capacity. More man pages would be fine--though I 
think we might do best to simply include links to the Wiki, which we can 
keep up to date. The utilities are tending to evolve quickly--especially 
the osis2mod & tei2mod utilities. So we can have 2 or 3 decent revisions 
of the utils between releases of the library, and the Wiki is a better 
tool for improving docs than man pages would be. I just imagine that man 
pages, once created, would go unmaintained after one or two revisions.

--Chris