[mercury-users] Custom declarations and preprocessors.

[Peter Schachte]

On Fri, Apr 14, 2000 at 10:29:52AM +1000, Robert Ernst Johann JESCHOFNIK wrote:
> On Thu, 13 Apr 2000, Tomas By wrote:
> 
> > The correct solution to this problem is literate programming. :-)
> 
> Literate programming addresses a different issue. The idea of Anthony's
> mdoc tool is to allow the automatic generation of LaTeX tables of the
> declarations you have made in your module, whereas literate programming 
> is just a way of handling comments inside the source in a nicer fashion.

Most literate programming tools also generate some kinds of indices.  That
*is* part of literate programming.

The basic idea is an attitude shift from "I'm telling the compiler what to
do" to "I'm presenting my module to interested human readers."  It seems to
me that what is being discussed for these :- doc constructs does fit into
the literate programming model, although it doesn't do all of what literate
programming does.

-- 
Peter Schachte                     True development puts first those that
mailto:schachte at cs.mu.OZ.AU        society puts last.
http://www.cs.mu.oz.au/~schachte/      -- Mahatma Gandhi 
Phone:  +61 3 8344 9166            
Fax:    +61 3 9348 1184            
--------------------------------------------------------------------------
mercury-users mailing list
post:  mercury-users at cs.mu.oz.au
administrative address: owner-mercury-users at cs.mu.oz.au
unsubscribe: Address: mercury-users-request at cs.mu.oz.au Message: unsubscribe
subscribe:   Address: mercury-users-request at cs.mu.oz.au Message: subscribe
--------------------------------------------------------------------------