[mercury-users] Custom declarations and preprocessors.

[Tomas By]

Ralph Becket writes:
> > From: Peter Schachte [mailto:schachte at cs.mu.OZ.AU]
> > 
> > > Anthony Senyard <anthls at cs.mu.oz.au> is working on a Mercury
> > > documentation tool that allows
> > > 
> > > 	:- doc(predname/arity, "Some comment about the predicate").
> > 
> > It seems more natural to me to put this kind of documentation 
> > in the source file as a comment...
> 
> I agree completely.  By all means come up with a comment-embedded
> mark-up language and, say, a documentation-extraction-tool-friendly
> coding style, but I can't see any advantage to extending the language
> itself with commenting directives (in fact, it'd be a royal pain).

<aol>me too</aol>

The correct solution to this problem is literate programming. :-)

(http://www.faqs.org/faqs/literate-programming-faq/)

/Tomas
--------------------------------------------------------------------------
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
--------------------------------------------------------------------------