Re: docbook?
On Wednesday, 27 July 2005 at 08:54, Brendan Cully wrote:
> On Wednesday, 27 July 2005 at 10:44, David Champion wrote:
> > I would propose that one person take existing documentation files and do
> > any translation that can be done by script, producing something roughly
> > approximating docbook. Then he or she would parcel these files up into
> > manageable chunks and hand them out to volunteers. The volunteers
> > could then send their parcels to a second-stage proofreader, who would
> > pass them back to the first person to be reassembled. This way it
> > doesn't become an overwhelming task for one or two people, but something
> > achievable by distributed means.
> >
> > That first person would need to be familiar with docbook, though. :)
>
> A lot of this can probably be done simply by running sgmltools -b
> lb2db on the sgml files. Then the proofreading and hand tuning kicks
> in. The other task is to rewrite makedoc to produce docbook
> output. This is also probably pretty straightforward, but it does
> require learning docbook first. I learned enough to be dangerous a
> while ago, but have since forgotten it all...
I've played around with this a little bit and it doesn't look like the
ld2db output is quite functional. I'd have to dig into docbook a bit
more to figure out how easily those errors can be resolved.