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

List:       kde-core-devel
Subject:    Re: KLauncher API documentation
From:       David Faure <faure () kde ! org>
Date:       2005-12-18 20:59:46
Message-ID: 200512182159.47004.faure () kde ! org
[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 :)  

Not when using unsermake --real-compare.

-- 
David Faure, faure@kde.org, sponsored by Trolltech to work on KDE,
Konqueror (http://www.konqueror.org), and KOffice (http://www.koffice.org).
[prev in list] [next in list] [prev in thread] [next in thread]