From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 1714 invoked by alias); 4 Mar 2014 01:18:17 -0000 Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org Received: (qmail 1632 invoked by uid 89); 4 Mar 2014 01:18:16 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-2.1 required=5.0 tests=AWL,BAYES_00,RCVD_IN_DNSWL_NONE,RP_MATCHES_RCVD autolearn=ham version=3.3.2 X-HELO: elasmtp-dupuy.atl.sa.earthlink.net Received: from elasmtp-dupuy.atl.sa.earthlink.net (HELO elasmtp-dupuy.atl.sa.earthlink.net) (209.86.89.62) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Tue, 04 Mar 2014 01:18:14 +0000 Received: from [68.96.200.16] (helo=macbook2.local) by elasmtp-dupuy.atl.sa.earthlink.net with esmtpa (Exim 4.67) (envelope-from ) id 1WKdzo-0001am-R5 for gdb-patches@sourceware.org; Mon, 03 Mar 2014 20:18:12 -0500 Message-ID: <531529D4.3050309@earthlink.net> Date: Tue, 04 Mar 2014 01:18:00 -0000 From: Stan Shebs User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.7; rv:24.0) Gecko/20100101 Thunderbird/24.3.0 MIME-Version: 1.0 To: gdb-patches@sourceware.org Subject: Re: [PATCH] Doxygenate gdbtypes.h References: <53151B5D.5000309@earthlink.net> <201403040039.s240db0w008027@glazunov.sibelius.xs4all.nl> In-Reply-To: <201403040039.s240db0w008027@glazunov.sibelius.xs4all.nl> Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit X-ELNK-Trace: ae6f8838ff913eba0cc1426638a40ef67e972de0d01da9403893d3fc1e75329c3f73708afe29112e350badd9bab72f9c350badd9bab72f9c350badd9bab72f9c X-IsSubscribed: yes X-SW-Source: 2014-03/txt/msg00056.txt.bz2 On 3/3/14 4:39 PM, Mark Kettenis wrote: >> Date: Mon, 03 Mar 2014 16:16:29 -0800 >> From: Stan Shebs >> >> 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