Hello, it would be great if there will be any docs about proper CMake modules docs (pun not intended).
E.g., how is better to document the Doxygen-like thinks like @brief, @param, @returns, @example, etc
and how it integrate with Doxygen/Breathe docs.
Thanks in advance for your attention.
VTK does this by using a Perl script that keeps comments and top-level names, but strips out everything else. This way it looks like a C declaration and Doxygen can do its normal thing. Here’s the script: https://gitlab.kitware.com/vtk/vtk/-/blob/master/Utilities/Doxygen/filters/cmake2c.pl