Re: [boost] Re: Review: Boost Coding Guidelines

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