[distcc] DocBook version of distcc manual

Martin Pool mbp at samba.org
Fri Jan 31 00:30:43 GMT 2003

Moin moin,

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
> improvements.

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 mailing list