Re: [boost] Interfaces Library, a macro less implementation

From: Joel de Guzman (joel_at_[hidden])
Date: 2005-07-01 00:28:19

Rene Rivera wrote:
> 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?

I suppose so, yes. Stefan also noted that Synopsos can also
be trained to understand macros. But what about other tools?
How about UML tools? Refactoring tools? Others, etc?

Regards,
-- 
Joel de Guzman
http://www.boost-consulting.com
http://spirit.sf.net