As I kind of expected, there were only a few comments on the "new 
format" documentation, though maybe I haven't given people enough time. 
Anyway, I have picked up on some (but not all) of the points that were 
raised, and improved things just a little bit. If you are still 
interested, you might like to look at these files:

http://www.cus.cam.ac.uk/~ph10/eximdoc/HowItWorks.txt
http://www.cus.cam.ac.uk/~ph10/eximdoc/AdMarkup.txt
http://www.cus.cam.ac.uk/~ph10/eximdoc/filter.html
http://www.cus.cam.ac.uk/~ph10/eximdoc/filter.info
http://www.cus.cam.ac.uk/~ph10/eximdoc/filter.pdf
http://www.cus.cam.ac.uk/~ph10/eximdoc/filter.ps.bz2
http://www.cus.cam.ac.uk/~ph10/eximdoc/filter.txt.bz2
http://www.cus.cam.ac.uk/~ph10/eximdoc/spec.html.tar.bz2
http://www.cus.cam.ac.uk/~ph10/eximdoc/spec.info.tar.bz2
http://www.cus.cam.ac.uk/~ph10/eximdoc/spec.pdf
http://www.cus.cam.ac.uk/~ph10/eximdoc/spec.ps.bz2
http://www.cus.cam.ac.uk/~ph10/eximdoc/spec.txt.bz2
http://www.cus.cam.ac.uk/~ph10/eximdoc/spec.xml.bz2

The first one is a description of how the XML is processed in various
ways in order to produce the final output. The second file describes the 
AsciiDoc markup that is used. The final file is the XML source; the 
remainder are the various renditions.

Nobody has come shouting "Don't Do It!", so my assumption is that people 
are prepared to accept the new documentation renditions. It is somewhat 
of a step back as well as a step forward (I have been unable to refrain 
from a few mutterings in HowItWorks.txt) but perhaps in the long run we 
can improve things.

Unless anybody now shouts "NO" very quickly, I propose to put all the 
relevant files into the CVS, and to produce the next edition (4.60, 
whenever that arrives - it won't be soon) using the new methodology.
When that is released, I will arrange to be deaf to complaints that
people should have raised at this stage. :-)

Speak now, or forever hold your peace.

Philip

-- 
Philip Hazel            University of Cambridge Computing Service,
[EMAIL PROTECTED]      Cambridge, England. Phone: +44 1223 334714.

-- 
## List details at http://www.exim.org/mailman/listinfo/exim-dev Exim details 
at http://www.exim.org/ ##

Reply via email to