From: Steve Lloyd (firstname.lastname@example.org)
Date: Tue Oct 12 2004 - 00:19:34 PDT
Not to forget that this technique is just as applicable to XSLT
Or the even simpler technique of documenting stylesheets described in
of the Docbook XSL Stylesheets"
I guess we've absolutely no excuse for failing to document XSLT well ;-)
Werner Donné wrote:
> I couldn't agree more. Remember TeX was written in WEB, according to
> the "Literate Programming Paradigm", which was introduced by Donald
> A WEB source file contains the code as well as the documentation of the
> code. The idea was to write a programme as if it were a book. TeX is the
> main example of that paradigm.
> You would extract the code and the documentation from a WEB file with
> TANGLE and WEAVE. The nice thing is that the TeX code documentation is
> processed by TeX itself.
> Those ideas are twenty years old, but I find them still to be very
> See also http://www.literateprogramming.com/.
> Sebastian Rahtz wrote:
>> Jim Melton wrote:
>>>> ...after all, you can
>>>> read the entire source code of TeX...
>>> Now, there's a statement that needs a smiley if I ever saw one!
>> maybe. but can you think of any program with source code you could
>> read more easily? the source of TeX is small, by todays standards,
>> available in nicely printed books in the shop, is well documented and
>> cross-referenced, acknowledged to be bug free for all intents and
>> and written by one of the foremost authorities on computer programming.
>> *I* can't understand it, but I'm not a professional programmer.
>> (*) To unsubscribe, send a message with words 'unsubscribe xep-support'
>> in the body of the message to email@example.com from the address
>> you are subscribed from.
>> (*) By using the Service, you expressly agree to these Terms of
>> Service http://www.renderx.com/tos.html
-- Steve Lloyd, XML Developer-Editorial Production Dept. International Baccalaureate Organisation Tel: +44 29 2054 7869 FAX: +44 29 2054 7778 ------------------- (*) To unsubscribe, send a message with words 'unsubscribe xep-support' in the body of the message to firstname.lastname@example.org from the address you are subscribed from. (*) By using the Service, you expressly agree to these Terms of Service http://www.renderx.com/tos.html
This archive was generated by hypermail 2.1.5 : Tue Oct 12 2004 - 00:42:22 PDT