Re: [PATCH] Doxygenate gdbtypes.h

[Joel Brobecker <brobecker@adacore.com>]

> 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.
> 

I don't know yet how much I like Stan's approach and Doxygen, but
I support him in his efforts. And I need to also say that I am tired
of comments like this one that simply denegate someone's effort without
providing alternatives. And, I mean, real work. Not just shoulda/coulda/
woulda. What Mark and yourself are saying might be true, but you chose
to just criticize without substance. So I invite Stan and others to
simply ignore this destructive type of criticism, and I invite you
to stop sending it in that form.

I know both of you have a rich history of contributing to various
GNU projects, or free software in general, and I am not attacking that.
But someone is trying to improve our documentation, and the only
suitable answers are, IMO, to either support him, and guide him
towards alternatives.

-- 
Joel