This is the mail archive of the gdb-patches@sourceware.org mailing list for the GDB project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: [PATCH] Doxygenate gdbtypes.h


On 3/3/14 4:39 PM, Mark Kettenis wrote:
>> Date: Mon, 03 Mar 2014 16:16:29 -0800
>> From: Stan Shebs <stanshebs@earthlink.net>
>>
>> Since minsyms.h and utils.h are churning a bit, I turned my attention to
>> gdbtypes.h.  As with defs.h, I've done only minimal content change,
>> although the patch looks large because of many unavoidable paragraph
>> refills.
>>
>> I added an additional block comment at the top that is a bit of general
>> discussion, similar to content that was in gdbint.texinfo.  Doxygen
>> starts to win for us here, as not only does it create a separate page
>> for this block, but mentions of symbols become links to definitions and
>> detailed documentation.
>>
>> I'll push this in a few days.
> 
> I wish you didn't.  This really adds a lot of random garbage all
> through the comments we carefully wrote over the last 20 years.
> It's an act of vandalism.
> 

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

However, if the majority of maintainers speak up and say that they've
changed their minds and no longer like this idea, I'll certainly
revert what I've done so far and go look for something else to do.

Stan
stan@codesourcery.com


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]