upstream .. issue
Paolo, thanks for watching. Doxygen works as expected.
In the past, it accepted group commands without being in a "special comment section". Since version 1.8.16, Doxygen requires a "special
comment section". Again, as designed, Doxygen does not see those group commands now. Consequently, Doxygen does not emit any warning. And the resulting documentation might† be broken. Actually, I noticed this
initially with libopusfile which had empty documentation in chapter 4
because of that [1].
Consequently, Doxygen has no issue. However, looking at the amount of
projects affected, a feature request for Doxygen could be to emit a
warning if such an "old" style group command is found. Not sure.
† That is the problem: It might be obvious. It might be not so obvious change in the resulting documentation. Even in libopusfile, where it was obvious and reported by two other users over a year span, it took me
some time to find the cause.
[1] <
https://gitlab.xiph.org/xiph/opusfile/-/merge_requests/34>
--- SoupGate-Win32 v1.05
* Origin: fsxNet Usenet Gateway (21:1/5)