{"action":"opened","issue":{"url":"https://api.github.com/repos/doxygen/doxygen/issues/5729","repository_url":"https://api.github.com/repos/doxygen/doxygen","labels_url":"https://api.github.com/repos/doxygen/doxygen/issues/5729/labels{/name}","comments_url":"https://api.github.com/repos/doxygen/doxygen/issues/5729/comments","events_url":"https://api.github.com/repos/doxygen/doxygen/issues/5729/events","html_url":"https://github.com/doxygen/doxygen/issues/5729","id":337473984,"node_id":"MDU6SXNzdWUzMzc0NzM5ODQ=","number":5729,"title":"unexpected documentation structure generated for groups with different member types (Origin: bugzilla #743835)","user":{"login":"doxygen","id":1300762,"node_id":"MDQ6VXNlcjEzMDA3NjI=","avatar_url":"https://avatars3.githubusercontent.com/u/1300762?v=4","gravatar_id":"","url":"https://api.github.com/users/doxygen","html_url":"https://github.com/doxygen","followers_url":"https://api.github.com/users/doxygen/followers","following_url":"https://api.github.com/users/doxygen/following{/other_user}","gists_url":"https://api.github.com/users/doxygen/gists{/gist_id}","starred_url":"https://api.github.com/users/doxygen/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/doxygen/subscriptions","organizations_url":"https://api.github.com/users/doxygen/orgs","repos_url":"https://api.github.com/users/doxygen/repos","events_url":"https://api.github.com/users/doxygen/events{/privacy}","received_events_url":"https://api.github.com/users/doxygen/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":0,"created_at":"2018-07-02T11:09:04Z","updated_at":"2018-07-02T11:09:04Z","closed_at":null,"author_association":"OWNER","body":"status NEW severity *normal* in component *general* for *---*\nReported in version *1.8.9.1* on platform *Other*\nAssigned to: Dimitri van Heesch\n\nOn 2015-02-02 08:32:55 +0000, Joachim Reichel wrote:\n\n> When processing this piece of code with the default settings of 1.8.9.1\n> \n> \n> /// C\n> class C\n> {\n> public:\n>     /// Some constant\n>     static const int constant = 42;\n> \n>     /// \\name Foo\n>     //@{\n>     void foo();\n>     //@}\n> \n>     /// \\name Bar\n>     //@{\n>     void bar();\n>     enum Enum { Enumerator };\n>     //@}\n> };\n> \n> \n> the documentation for class C has the following structure:\n> \n> \n> Public Member Functions\n> * Foo\n> Static Public Attributes\n> Bar\n> \n> \n> The correct structure would be\n> \n> Public Member Functions\n> * Foo\n> * Bar\n> Static Public Attributes\n> \n> (or maybe Foo and Bar reversed)\n> \n> For some reason the \"Bar\" group is one level too high in the document structure.\n\nOn 2015-02-03 19:35:12 +0000, Dimitri van Heesch wrote:\n\n> By default Doxygen first groups members of the same type and then groups members according to members groups within those \"member type\" groups. \n> \n> If you have more than one type of member in one group (like an enum and function in your example) this would not be correct (Enum is not a Public Member Function in your example), so the whole group is promoted one level up, as you observed. \n> \n> If you want to do this for all groups consistently, then set SUBGROUPING to NO.\n> \n> If you don't want to do this, then only put members of the same type in a member group.\n> \n> Let me know if this 'solves' your problem.\n\nOn 2015-02-05 13:55:56 +0000, Joachim Reichel wrote:\n\n> Thanks for the explanation. I guess what I really expected is a structure like\n> \n> Public Member Functions\n> * Foo\n> * Bar\n> Static Public Attributes\n> * Bar\n> \n> (The last \"Bar\" was missing in my first post.)\n> \n> That is, SUBGROUPING = YES, but additionally split member groups into multiple parts according to the member type. This preserves the overall documentation structure while adding another structuring level within each member type (at the cost of splitting member groups).\n> \n> I understand that this is not (yet?) implemented. Feel free to track this as a feature request if you consider this worthwile or close the report as invalid.\n\n"}}
{"actor":{"display_login":"doxygen"}}