Re: Mass Bug Filing: Doxygen Group Commands (was: Search content (.h files) of all (-dev) packages?)
> mass-bug-filing against the ones that FTBFS
Thanks for the idea. Fails To Build From Source. Although not tested, I
guess, not one (-doc) package will fail to build. Doxygen simply ignores
group commands in standard comments by now. Doxygen requires everything
to be in a Special Comment Block [1] by now.
My issue is like a nit-pick about those projects' Doxygen compatible
documentation because I do not even know if they still support Doxygen.
For those who do support Doxygen, this might be beneficial because the
cause of the error was terrible to find, at least for me. However, I am
really unsure how to report that.
On the other hand, looking at the first dozen projects, quite a lot had
not run Doxygen for years, some not for a decade. Actually, I picked
Digium Asterisk as a larger project. The first challenge was to
configure Doxygen "correctly". After that, I faced 2369 warnings. And
the few existing group commands were all left-overs actually.
Currently, I do not think I mass-bug-file: It is simply a too small
issue in far too many projects.
[1] <https://www.doxygen.nl/manual/docblocks.html#specialblock>
Reply to: