api docs [was: KInstance redesign]

[Dominik Haumann]

On Friday 19 January 2007 13:15, Matthias Kretz wrote:
> Hi,
>
> after Thiago suggested to fix the static destruction issue by refcounting
> KInstance to keep it until everything that needs it is gone, I started to
> wonder if we want to keep KInstance the way it is now or whether we may
> dare to change it completely. (LXR says 1683 references in 826 files...
> so much for porting efforts)
>
> First I think it's hard to understand what KInstance actually is supposed
> to do. Perhaps the first step would be to define what it's used for and
> then give it a better name. Here's how I understand it:
> - without components KInstance is not needed; it could be replaced by
> KGlobal - but components want some pseudo-global data, different from the
> host application
> - also in an application there is always only one active component which
> can be identified using KGlobal::activeInstance

this is a nice addon to what we have as class documentation right now:
http://api.kde.org/cvs-api/kdelibs-apidocs/kdecore/html/classKInstance.html
If you are going to work on it anyway, it would be cool if you could add 
some of this :)

Greetings,
Dominik