[mercury-users] Custom declarations and preprocessors.

[Ralph Becket]

> 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).

--
Ralph Becket      |      MSR Cambridge      |      rbeck at microsoft.com 
--------------------------------------------------------------------------
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
--------------------------------------------------------------------------