From: Rene Rivera (grafik.list_at_[hidden])
Date: 2005-06-30 18:55:40
Joel de Guzman wrote:
> 2) Interfaces need to be documented. They need to be parsable
> by an automatic documentation extraction tool such as
> Doxygen or Synopsis.
I don't know about Synopsis, but with Doxygen which I use for
documenting my code. In my interfaces, mentioned long ago, macro IDL I
just define the appropriate macros so that during documentation parsing
things expand out to simple method declarations.
Is that an acceptable avenue in your view?
-- -- Grafik - Don't Assume Anything -- Redshift Software, Inc. - http://redshift-software.com -- rrivera/acm.org - grafik/redshift-software.com -- 102708583/icq - grafikrobot/aim - Grafik/jabber.org
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk