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

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