kdelibs API documentation (was Re: Moving ThreadWeaver to kdelibs)

[Kevin Krammer]

On Thursday 15 September 2005 20:01, Adriaan de Groot wrote:

> You can also use grouping, for instance you can do
>
> /** @defgroup implementors Notes for Implementations */
>
> /** Do something cool. */
>
> void coolness();
>
> /** @addtogroup implementors
>
> These are the notes about a method relevant for implementors; they should
> come after the method definition and @em before the dox for the next
> method. To implement coolness, you need a baseball cap.
> */

Interesting, will have to try this.

> I'm not entirely sure how these come out; alternatively, subpaging may be
> an option -- I can figure that out for you if you like and write up a
> suggested dox style for interfaces.

That would be great!

Given that we already have quite some interfaces and will likely have even 
more in KDE4, it would be good IMHO to make this case part of the 
recommendations or style guidelines.

Cheers,
Kevin

-- 
Kevin Krammer <kevin.krammer at gmx.at>
Qt/KDE Developer, Debian User
Moderator: www.mrunix.de (German), www.qtforum.org
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
URL: <http://mail.kde.org/pipermail/kde-core-devel/attachments/20050915/4da6105d/attachment.sig>