Re: docs squid3/src/ICAP ICAPInitiate.h,1.2,1.2.10.1

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.
Received on Tue Jul 31 2007 - 13:22:43 MDT