[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-core-devel
Subject:    Re: KLauncher API documentation
From:       Kevin Krammer <kevin.krammer () gmx ! at>
Date:       2005-12-18 15:31:39
Message-ID: 200512181631.39653.kevin.krammer () gmx ! at
[Download RAW message or body]


On Sunday 18 December 2005 18:12, Benjamin Meyer wrote:
> On Sunday 18 December 2005 1:41 pm, Dominik Haumann wrote:
> > On Sunday 18 December 2005 00:34, Frans Englich wrote:
> > [...]
> >
> > > IMHO, documentation is always valuable. Of course, in the case that the
> > > documentation is read by vastly more readers(which it is, when part of
> > > a public API), it is even more valuable.
> >
> > I agree. There is one negative effect though: it bloats up the header
> > files so that it gets complex. That's the reason (I *guess*) why tt puts
> > everything into the cpp files. ;)
> >
> > cu,
> > Dominik
>
> Don't forget that fixing documentation in a header makes you re-compile
> everything that depends upon that header :)

True, but the documentation in headers is still available when the respective 
-devel package is installed, source files are not.

Cheers,
Kevin

-- 
Kevin Krammer <kevin.krammer@gmx.at>
Qt/KDE Developer, Debian User
Moderator: www.mrunix.de (German), www.qtforum.org

[Attachment #3 (application/pgp-signature)]

[prev in list] [next in list] [prev in thread] [next in thread]