Gather uncategorized documentation in Sphinx
We have inline documentation in the form of Doxygen comments. We have a few Doxygen groups defined, and the ReST documentation pulls those groups in.
We have also code that is documented with Doxygen but not in any group, or is in a group but ReST does not reference it. These Doxygen documentations do not end up in the Sphinx generated HTML. I want this missed portion of documentation appear somewhere in the HTML, perhaps in some index of uncategorized stuff.
There is doxygenindex
, but using that will cause a lot of warnings about Duplicate target detected
and rightfully so as it also includes all the groups we already have in the docs explicitly.
How can we find all the inline documentation that is not in any proper group referenced explicitly in ReST yet?
Just a list would be good as a todo, even better if we can include all that doc in Sphinx so it becomes discoverable before we have everything sorted out into proper groups.