From kde-core-devel  Sun Feb 27 16:12:54 2000
From: Richard Moore <rich () ipso-facto ! freeserve ! co ! uk>
Date: Sun, 27 Feb 2000 16:12:54 +0000
To: kde-core-devel
Subject: Re: enums in kdoc
X-MARC-Message: https://marc.info/?l=kde-core-devel&m=95166798818546



Sirtaj Singh Kang wrote:
> 
> On Fri, Feb 25, 2000 at 11:29:43PM +0100, Stephan Kulow wrote:
> > Hi!
> 
> > http://developer.kde.org/documentation/library/2.0-api/classref/kio/KIO.html
> > looks _very_ strange with this lenghty enum line. Can someone think
> > of a better solution? We also need to document what which value means
> > - is there a way to do this with kdoc? And I would like to see it
> > removing the real values. We put them there for better debugging,
> > but it doesn't really belong in the docu.
> 
> If you can come up with a good solution for what should be shown I will
> implement it, but I'm busy with two (KDE and non-KDE) projects right
> now so it will have to wait for a bit. Or you're welcome to send me a
> patch for kdoc now that you're a perl convert. :)
> 
> Documenting enum constants will be a bit harder though.

How about something like this:

/**
 * This enum stores the constants used to represent the state of something.
 */
enum MyState {
  //* @enum The object is active
  Active = 1,
  //* @enum The object is passive
  Passive = 2
};

/**
 * This is a bitflag enum
 */
enum MyFlags {
  //* @flag The first flag
  One = 0x1,
  Two = 0x2,
  Three = 0x4
};

Rich.

> 
> -Taj.
> 
> Sirtaj S. Kang       taj@kde.org         ssk@physics.unimelb.edu.au
> Univ of Melbourne       The "gui" in "Penguin" is pronounced "K-D-E"

-- 
     Richard Moore		rich@ipso-facto.freeserve.co.uk
http://www.robocast.com/	richard@robocast.com
http://developer.kde.org/	rich@kde.org