[distcc] DocBook version of distcc manual
mbp at samba.org
Fri Jan 31 00:30:43 GMT 2003
On 31 Jan 2003, Frerich Raabe <raabe at kde.org> wrote:
> I just finished a first conversion of the distcc manual to DocBook 4.2 XML,
> which is IMHO the most appropriate (and the nicest) format for such a task.
That's great! Thankyou.
It's a more standard format and it may also be easier for BSD people
to process than Linuxdoc-SGML.
> I noticed that the TODO file suggests using DocBook Lite, but that is only
> appropriate for short documents, like articles, so this version uses the
> "full blown" DocBook, which I don't perceive as overkill.
OK. I had just started looking at the two of them, so I'm happy to go
with the full-strength version.
> While I was busy converting the document (and god knows I'm no expert with
> this, I didn't even write a single megabyte of docbook markup yet), I also
> tried to correct a few errors in the documentation, such as typos; sometimes
> I was able to correct actual errors in the documentation (like, 4200 is not
> the default port anymore).
OK. As it happens I was looking at a printout last night and spotted
some other things that need to be fixed.
Can you tell me what CVS version of the manual you started from so
that I know if any other changes have to be merged?
> In any case, I would appreciate it if people could look through this, help
> spot typos, inaccurate or suboptimal expressions, and perhaps suggest
There are a couple of validation warnings. I'll check it in to CVS
later today and we can sort out any problems from there.
More information about the distcc