On Tue, 21 Jun 2005, Alan J. Flavell wrote:
> If there's a problem with
> http://www.exim.org/exim-html-4.50/doc/html/spec.html
> it's the fact that it launches into frames. I'm no friend of frames
> (it makes difficulties with bookmarking and citing URLs), but the
> material is there anyway. If any work is called for, then that's
> where I'd like to see it invested.
I have recently invested a lot of work. The next release of the
documentation will come from a new source, held as an AsciiDoc document.
This is translated into DocBook XML, from which all the output formats
are generated, using generally available free software (but with a
number of customised stylesheets and pre- and post-processing scripts).
There are no frames in the HTML version. I am not happy with several of
the details, especially some of the typography in the PostScript/PDF
formats. However, it does seem "the right way to go" to move to a
standard format (DocBook XML) and hope that the tools for processing it
get better in due course.
If anyone wants to generate any new formats, the place to invest effort
is in converting from DocBook XML to their chosen format.
--
Philip Hazel University of Cambridge Computing Service,
ph10@??? Cambridge, England. Phone: +44 1223 334714.
Get the Exim 4 book: http://www.uit.co.uk/exim-book
