After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 762320 - individual values in enum not documented if the enum is a member of a C class
individual values in enum not documented if the enum is a member of a C class
Status: RESOLVED OBSOLETE
Product: doxygen
Classification: Other
Component: documentation
1.8.11
Other Windows
: Normal normal
: ---
Assigned To: Dimitri van Heesch
Dimitri van Heesch
[moved_to_github]
Depends on:
Blocks:
 
 
Reported: 2016-02-19 12:54 UTC by Mikkel Haugstrup Jensen
Modified: 2018-07-30 10:23 UTC
See Also:
GNOME target: ---
GNOME version: ---

Attachments
Generated output with default configuration (50.63 KB, image/png)
2016-02-19 12:54 UTC, Mikkel Haugstrup Jensen 		Details

Description Mikkel Haugstrup Jensen 2016-02-19 12:54:34 UTC 
Created attachment 321654 [details]
Generated output with default configuration

In the below example public_value and public_enum is included as members of test. But the values of public_enum are discarded - the documentation in meaning of a and meaning of b is excluded from the generated output.

/**
 * \class test
 */
struct test 
{
  /** some value */
  int public_value;
};

/**
 * class scoped enum
 * \memberof test
 */
enum public_enum {
   /**
    * meaning of a
    */
   a,
  
   /**
    * meaning of b
    */
   b
};
Comment 1 Florian_ 2016-08-17 09:01:29 UTC 
Same happens when using \relates or \relatesalso instead of \memberof.

See similar bug #609299 (reported 10 years ago...).

Another (imho) wrong side-effect: When using \relates, the enum appears in section "Related Functions" of the mentioned class.
Comment 2 Florian_ 2016-08-18 10:24:12 UTC 
Here's a quick fix which solves the issue (in 1.8.11):
http://stackoverflow.com/a/38996393/3518248

Might have side-effects, one of you Doxygen guys should have a look...
Comment 3 André Klapper 2018-07-30 10:23:33 UTC 
As discussed in https://github.com/doxygen/doxygen/pull/734 , Doxygen has moved its issue tracking to 

   https://github.com/doxygen/doxygen/issues

All Doxygen tickets in GNOME Bugzilla have been migrated to Github. You can subscribe and participate in the new ticket in Github. You can find the corresponding Github ticket by searching for its Bugzilla ID (number) in Github.

Hence I am closing this GNOME Bugzilla ticket.
Please use the corresponding ticket in Github instead. Thanks a lot!