[Doxygen-users] [DOXYGEN] Addressing "unbalanced grouping command" warnings in ITK

[Jon H. L. G. <jon...@gm...>]

Hi,
I am trying to fix/improve some Doxygen related warnings/aspects in
ITK, and I have a few questions:

1. Our Doxygen build is raising a number of "unbalanced grouping
commands" warnings:
https://open.cdash.org/viewBuildError.php?type=1&buildid=8167118

They usually point to the end of the file, e.g.
https://github.com/InsightSoftwareConsortium/ITK/blob/master/Modules/Core/Common/include/itkAutoPointer.h#L261
or
https://github.com/InsightSoftwareConsortium/ITK/blob/master/Modules/Core/Common/include/itkBSplineInterpolationWeightFunction.h#L136

Although I have done some investigation across the Doxygen
documentation and GitHub issues I have not found any solution to the
above warnings.

Following the warning description I am guessing that these might be
due to a potential improper use of "\ingroup" commands in our files,
or the impossibility to correctly interpret them the way we define our
groups.

Besides the code modules that we parse as groups:
https://github.com/InsightSoftwareConsortium/ITK/blob/d12f14e105500362a30264e683a4045eed21ba14/CMake/ITKGroups.cmake

we define a number of other groups in
https://github.com/InsightSoftwareConsortium/ITK/blob/bcac6f9db2cb134d3d3c60a21041cde136feb1d9/Documentation/Doxygen/Modules.dox

That give rise to the Doxygen page:
https://itk.org/Doxygen/html/modules.html

Despite the warnings, many of these filters seem to display the
modules/groups they belong to correctly in the header of the file,
e.g.
"Data Processing Objects » FunctionsData Processing Objects »
Functions » Image Functions » | Image InterpolatorsGroup Core » |
Module ITKCommon"
https://itk.org/Doxygen/html/classitk_1_1BSplineInterpolationWeightFunction.html

So I am wondering how to fix the warnings.

2. Additionally, I am wondering how we can link automatically the
modules: e.g. the ITKTransform module is not being automatically
linked in the Group Registration description in:
https://itk.org/Doxygen/html/modules.html


Thanks.