This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
Re: [PATCH] Doxygenate gdbtypes.h
- From: ludo at gnu dot org (Ludovic CourtÃs)
- To: gdb-patches at sourceware dot org
- Date: Tue, 04 Mar 2014 18:36:29 +0100
- Subject: Re: [PATCH] Doxygenate gdbtypes.h
- Authentication-results: sourceware.org; auth=none
- References: <53151B5D dot 5000309 at earthlink dot net> <201403040039 dot s240db0w008027 at glazunov dot sibelius dot xs4all dot nl> <531529D4 dot 3050309 at earthlink dot net>
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â.