From: John Max Skaller (skaller_at_[hidden])
Date: 2001-07-25 17:19:18
Beman Dawes wrote:
> There are also some Literate Programming tools available that fall
> somewhere between DocBook and Doxygen. I'm not really familiar with their
> pros and cons.
A short summary then: the principal difference between
this class of tool and LP tools is that LP tools extract
code from documents, whilst the other kind of tool extracts
documentation from code.
The effect of what appears to be, on the surface,
a subtle distinction is fundamental: LP requires a total
committment.Code extractors usually work on unprepared code,
though the results may not be pleasing.
-- John (Max) Skaller, mailto:skaller_at_[hidden] 10/1 Toxteth Rd Glebe NSW 2037 Australia voice: 61-2-9660-0850 New generation programming language Felix http://felix.sourceforge.net Literate Programming tool Interscript http://Interscript.sourceforge.net
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk