Re: [exim] Improving Exim Documentation: A Simple Suggestion

Top Page

Reply to this message
Author: Phil Pennock
Date:  
To: Mike Cardwell
CC: exim-users
Subject: Re: [exim] Improving Exim Documentation: A Simple Suggestion
On 2009-11-12 at 13:22 +0000, Mike Cardwell wrote:
> As for the static vs dynamic argument, XSLT is perfect for this sort of
> documentation. You shove the document content in some simple static
> files, and then write separate stylesheets for the html version of the
> doc, and the pdf version, etc.


XSLT is how the documentation is generated now, as part of the pipeline
from the docbook sources.

Historically, the Exim docs were maintained in a language local to
Cambridge, so it would be harder to make changes to old releases of the
docs this way, but since Exim 4.60 the docs have been maintained in
AsciiDoc format, which feeds into an XML pipeline.

http://vcs.exim.org/viewvc/exim/exim-doc/doc-docbook/HowItWorks.txt?revision=1.9&view=co

There is room for people who like document preparation systems to put
some love into this area. Just don't break the .txt or .pdf outputs
when working on the HTML. :)

-Phil