From: Steve Lloyd (steve.lloyd@ibo.org)
Date: Tue Oct 12 2004 - 00:19:34 PDT
Not to forget that this technique is just as applicable to XSLT
applications.
See http://nwalsh.com/docs/articles/xml2002/lp/paper.html.
Or the even simpler technique of documenting stylesheets described in
"The Design
of the Docbook XSL Stylesheets"
http://nwalsh.com/docs/articles/dbdesign/#litprog.
I guess we've absolutely no excuse for failing to document XSLT well ;-)
Steve
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
> Knuth.
> 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
> modern.
> See also http://www.literateprogramming.com/.
>
> Werner.
>
> 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
>> purposes,
>> and written by one of the foremost authorities on computer programming.
>> *I* can't understand it, but I'm not a professional programmer.
>>
>> Sebastian
>> -------------------
>> (*) To unsubscribe, send a message with words 'unsubscribe xep-support'
>> in the body of the message to majordomo@renderx.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 majordomo@renderx.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
This archive was generated by hypermail 2.1.5 : Tue Oct 12 2004 - 00:42:22 PDT