• Re: Mass Bug Filing: Doxygen Group Commands (was: Search content (.h fi

    From Alexander Traud@21:1/5 to All on Mon Nov 29 16:40:01 2021
    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>

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)