Нужно на странице группы в генерируемой doxygen'ом документации получить список всех членов этой группы, даже если они находятся в пространстве имён. Например, мы определяем группу и добавляем в неё класс через @{ @}:
/*!
@defgroup test_group Example group
@{*/
class some_class {};
/// @}
В данном случае всё в порядке, доксиген создаст страницу группы test_group, на которой будет искомый класс:
Но после добавления в код пространств имён доксиген начинает переносить их члены на отдельные страницы, например, результатом следующего фрагмента:
/*!
@defgroup test_group Example group
@{*/
namespace example_namespace {
class some_class {};
}
/// @}
Станут уже 2 страницы: страница группы (только с пространством example_namespace) и страница самого пространства, которая содержит классы, которые в нём находятся:
В данном случае все члены пространства имён переносятся на новую страницу. Как можно избежать подобного?
Варианты:
// 1. заключение содержимого пространства в блок @{ @}:
/// @defgroup test_group Example group
namespace example_namespace {
/*!
@ingroup test_group
@{ */
class some_class {};
/// @}
}
// 2. включение самого пространства в группу
/// @defgroup test_group Example group
/// @ingroup test_group
namespace example_namespace {
class some_class {};
}
Дают одинаковый результат, такой же как на втором изображении: страница группы, содержащая только namespace и отдельная страница пространства имён, на которой уже указано его содержимое.
Если прописать " @ingroup test_group " в описание каждого класса, то они добавляются корректно, но в проекте сотни классов, раскиданных по разным пространствам имён. Как можно выйти из подобной ситуации без тысяч ctrl+c - ctrl+v ?