New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

doxygen 1.8.6 sorts the contents of a namespace by group within the Class List (Origin: bugzilla #722619) #5410

Closed
doxygen opened this Issue Jul 2, 2018 · 0 comments

Comments

Projects
None yet
1 participant
@doxygen
Owner

doxygen commented Jul 2, 2018

status RESOLVED severity normal in component documentation for ---
Reported in version 1.8.6 on platform Other
Assigned to: Dimitri van Heesch

On 2014-01-20 17:10:55 +0000, J. P. Abelanet wrote:

This can be demonstrated with the trivial example based on the example from here:

http://www.stack.nl/~dimitri/doxygen/manual/grouping.html

/** namespace N0 contains all classes
*/
namespace N0 {

/** @defgroup group1 The First Group

  • This is the first group
  • @{
    */

/** @brief class Prefix5C1 in group 1 */
class Prefix5C1 {};

/** @brief class Prefix4C2 in group 1 */
class Prefix4C2 {};

/** function in group 1 */
void func() {}

/** @} */ // end of group1

/**

  • @defgroup group2 The Second Group
  • This is the second group
    */

/** @defgroup group3 The Third Group

  • This is the third group
    */

/** @defgroup group4 The Fourth Group

  • @InGroup group3
  • Group 4 is a subgroup of group 3
    */

/**

  • @InGroup group2
  • @brief class Prefix3C3 in group 2
    */
    class Prefix3C3 {};

/** @InGroup group2

  • @brief class Prefix2C4 in group 2
    */
    class Prefix2C4 {};

/** @InGroup group3

  • @brief class Prefix1C5 in @link group3 the third group@endlink.
    */
    class Prefix1C5 {};

/** @InGroup group1 group2 group3 group4

  • namespace N1 is in four groups
  • @sa @link group1 The first group@endlink, group2, group3, group4
  • Also see @ref mypage2
    */
    namespace N1 {};

/** @file

/** @defgroup group5 The Fifth Group

  • This is the fifth group
  • @{
    */

/** @page mypage1 This is a section in group 5

  • Text of the first section
    */

/** @page mypage2 This is another section in group 5

  • Text of the second section
    */

/** @} */ // end of group5

/** @addtogroup group1
*

  • More documentation for the first group.
  • @{
    */

/** another function in group 1 */
void func2() {}

/** yet another function in group 1 */
void func3() {}

/** @} */ // end of group1

}; // end of N0 namespace

On 2014-01-20 17:13:09 +0000, J. P. Abelanet wrote:

This is confusing to the viewer, because within this context the group is not indicated, making it look like the classes appear in a random or unspecified order within the namespace.

The documentation can be generated using the auto-generated Doxyfile.

On 2014-02-22 10:29:52 +0000, Dimitri van Heesch wrote:

Confirmed. Should be fixed in the next GIT update.

On 2014-02-22 19:07:43 +0000, J. P. Abelanet wrote:

Thanks for looking at this, and thanks, as always, for an outstanding product.

On 2014-04-21 10:09:31 +0000, Dimitri van Heesch wrote:

This bug was previously marked ASSIGNED, which means it should be fixed in
doxygen version 1.8.7. Please verify if this is indeed the case. Reopen the
bug if you think it is not fixed and please include any additional information
that you think can be relevant (preferrably in the form of a self-contained example).

@doxygen doxygen closed this Jul 2, 2018

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment