KWin missing in apidocs since KDE 3.3!

[Adriaan de Groot]

On Thursday 02 June 2005 14:51, Lubos Lunak wrote:
> On Wednesday 01 of June 2005 20:52, mETz wrote:
> > Moin,
> >
> > not only KTrader is missing since ages, now I also found KWin
> > documentation to be missing (even on developer.kde.org, so it's not my
> > broken doxygen).
> >
> > Somebody please fix this!
>
>  If I do 'make apidox' in kdebase/kwin, I see the generated docs in
> kdebase/apidocs, so I guess this is not up to me to fix this? Well at least
> I have no idea how and what exactly.

The problem is -- that is, if Metz' complaint refers to the libkdecore class 
KWin -- that the entire class is wrapped in a #ifdef Q_OS_UNIX, and that gets 
removed by Doxygen during (pre)processing. Disabling preprocessing so Doxygen 
ignores the #ifdef entirely causes the class KWin dox to be generated 
properly.

Patch to admin/Doxyfile.am attached. See 
http://www.stack.nl/~dimitri/doxygen/preprocessing.html for references.

PIM dox (should you care) don't suffer from this because they use a fork of 
admin/'s Doxygen stuff that already deals with preprocessing properly (and 
yields KDE-styled dox, too -- some day, Allen & I will have to discover who's 
turf the Dox stuff is in an attempt to merge back our changes).

-- 
These are your friends - Adem
    GPG: FEA2 A3FE Adriaan de Groot
-------------- next part --------------
A non-text attachment was scrubbed...
Name: dox.diff
Type: text/x-diff
Size: 498 bytes
Desc: not available
URL: <http://mail.kde.org/pipermail/kde-core-devel/attachments/20050602/af6d6306/attachment.diff>