Bug report: Doxygen comments using <summary> causes wrong documentation

openNURBS
,
1

After some searching for a place to report bugs, and not finding it, I figured maybe posting in the forum would suffice as well.

While scanning and reading the online Doxygen-produced documentation at Rhino C++ API: Main Page I kept noticing that sometimes documentation seems to be put on the wrong ‘topic’, usually being ‘one off’. Especially enum values seem to suffer from this.

Today I realized why: it is because each Doxygen comment uses the

command to create the summary. Because this is written -immediately- after the /// . This results in Doxygen interpreting the first ‘<’ as the ‘look-back-comment-operator’ . This is indeed clearly seen in the online output, where the literal word ‘summary>’ is appearing in the output.

I guess it should be sufficient to go over each source and ensure there is at least one space between the ‘///’ and the ‘<’