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

List:       kde-devel
Subject:    Re: KUtils docs
From:       Adriaan de Groot <groot () kde ! org>
Date:       2005-10-19 13:38:00
Message-ID: 200510191538.00327.groot () kde ! org
[Download RAW message or body]

On Wednesday 19 October 2005 17:17, Benjamin Meyer wrote:
> On Tuesday 18 October 2005 3:58 pm, Adriaan de Groot wrote:
> > Yeah, I was pretty thorough on them in the past few months, so anything
> > that has dox has almost zero errors. The only reason you see warnings
> > about missing dox in kdelibs is because I specifically turned that on for
> > _only kdecore_ to check if kdelibs was living up to the documentation
> > policy.
>
> I took a glance at it and noticed that it warned about some functions in
> kapplication that were documented, but marked internal, is that a problem?

It shouldn't be complaining about them - there's a doxygen tweak for that, 
grep for INTERNAL in the default configuration. After all, if they are marked 
@internal, then it's OK for the dox to be missing, broken, or egregiously 
misleading.

-- 
These are your friends - Adem
    GPG: FEA2 A3FE Adriaan de Groot
 
>> Visit http://mail.kde.org/mailman/listinfo/kde-devel#unsub to unsubscribe <<
[prev in list] [next in list] [prev in thread] [next in thread]