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. _______________________________________________ Doxygen-users mailing list Doxygen-users@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/doxygen-users
