Documenting enum class vs enum

Discuss how to use DoxyPress
Post Reply
usingcpp
Posts: 4
Joined: Thu Mar 09 2017 12:50 pm

Documenting enum class vs enum

Post by usingcpp »

Here is the code from the \enum documentation:

Code: Select all

class Test
{
  public:
    enum fruit { pear, orange };

    /*! Another enum, with inline docs */
    enum veggies 
    { 
      celery,   /*!< docs for value one */
      carrot    /*!< docs for value two */
    };
};

/*! \class Test
 * The class description.
 */

/*! \enum Test::fruit
 * A description of the fruit enum. 
 */

/*! \var Test::fruit Test::pear
 * The description of the first fruit.
 */
If I change the enum to an enum class, the documentation still generates correctly. But, what if I add another enum class, say otherFruit, which also has a pear value?

Code: Select all

   enum fruit { pear, orange };

/*! \var Test::otherFruit Test::pear
 * The description of the first otherFruit.
 */
The description for Test::otherFruit::pear is placed in the description for Test::fruit::pear and there is no documentation for Test::otherFruit::pear.

Trying:

Code: Select all

/*! \var Test::otherFruit Test::otherFruit::pear
causes DoxyPress to print:
Warning: documentation found, for a class member which was not found:
Test::otherfruit Test::otherFruit::pear
Is it possible to document enum classes this way?

There is a workaround: document the enum values inline. However, this is not mentioned in the \enum documentation. In fact, documenting enum class does not appear to be mentioned anywhere in the DoxyPress documentation.
ansel
Posts: 152
Joined: Fri Apr 10 2015 8:23 am

Re: Documenting enum class vs enum

Post by ansel »

Thank you for your report.

You mention trying the following syntax:

Code: Select all

/*! \var Test::otherFruit Test::otherFruit::pear
This syntax makes sense and should be allowed, but is not currently supported. I have filed a ticket to support this case:

http://redmine.copperspice.com/issues/31
Ansel Sermersheim
CopperSpice Cofounder
Post Reply