On Tue, 2007-07-31 at 20:03 +0200, Henrik Nordstrom wrote: > On tis, 2007-07-31 at 08:03 -0600, Alex Rousskov wrote: > > > > ! AsyncCallWrapper(93,3, ICAPInitiate, noteInitiatorAborted) > > > /**DOCS_NOSEMI*/ > > > Are there any alternative options to make doxygen happier without > > modifying the sources? Perhaps we can add a simple preprocessing script > > that would add the above crap before starting doxygen? > > It's possible to teach Doxygen about these "odd" defines, allowing it to > parse the code reasonably. > > http://www.stack.nl/~dimitri/doxygen/preprocessing.html
Great! > But I suppose it should also be possible to refactor many of these using > C++ templating, avoiding the need for defines in the first place.. I agree that many (most?) #defines should be eliminated in favor of inline functions, constants, and perhaps even an occasional template or two. The #defines related to asynchronous messages will be gone when the messaging/event support is improved. They are a necessary evil until then. Alex.
