Re: [exim-dev] Standardizing the Exim documentation

Top Page
Delete this message
Reply to this message
Author: Christoph Kliemt
Date:  
To: Philip Hazel
CC: exim-dev
Subject: Re: [exim-dev] Standardizing the Exim documentation
Philip Hazel <ph10@???> writes:

> I have spent a lot of time recently investigating what might be done to
> convert the Exim documentation sources (main manual and filter document)
> to some kind of standard text format. The executive summary is that I
> think it is not unreasonable to consider moving to XML DocBook format.


I played round with XML DocBook a few times. My personal impression:
Overkill for documentation[1], stylsheets sometimes do not work or need
a speclial xslt-processor.

> However, there are a lot of ifs and buts in the detail. Therefore, I
> have written a document about it. Please read the document at
>
> http://www.cus.cam.ac.uk/~ph10/exim-docbook.html
>
> A PDF version is available at
>
> http://www.cus.cam.ac.uk/~ph10/exim-docbook.pdf
>
> The document is 6 pages long (in the PDF version). Please send me your
> comments, views, and corrections to anything that I might have got
> wrong.
>
> Philip
>
> -- Philip Hazel University of Cambridge Computing Service,
> ph10@??? Cambridge, England. Phone: +44 1223 334714.
>
> --
> ## List details at http://www.exim.org/mailman/listinfo/exim-dev Exim
> details at http://www.exim.org/ ##



Footnotes:
[1] for the needs of exim documentation.

--
Christoph Kliemt
entici GmbH, Goldenbergstr.1
D 50354 Hürth
Phon + 49 (0) 22 33 92 82 44