Re: [PATCH] Doxygenate gdbtypes.h

[ludo@gnu.org (Ludovic Courtès)]

Stan Shebs <stanshebs@earthlink.net> skribis:

> Give the histrionics a rest, please.  You claimed it was against policy,
> but then you never replied when I asked what specific policy
> is being violated.

Just because some GNU packages use Doxygen (or CMake, or...) doesn’t
mean it’s a good idea; and it remains a GCS violation.

> Two extra characters per comment block is not a "lot of random
> garbage" or "vandalism" - over-the-top statements like that are not
> going to convince anybody of anything.

GNU has a history of well-written documentation and well-commented code.
The rationale is documented, and IMO still holds.

As a GNU user and hacker, I’ve long appreciated GNU’s luxurious approach.
In contrast, I view the approach that Doxygen, Javadoc & co. favor as an
insult to the reader.

So I can sympathize with Mark’s comment.

Thanks,
Ludo’.