From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 516 invoked by alias); 4 Mar 2014 00:39:45 -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 504 invoked by uid 89); 4 Mar 2014 00:39:45 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-2.3 required=5.0 tests=AWL,BAYES_00,RP_MATCHES_RCVD autolearn=ham version=3.3.2 X-HELO: glazunov.sibelius.xs4all.nl Received: from sibelius.xs4all.nl (HELO glazunov.sibelius.xs4all.nl) (83.163.83.176) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with (AES256-GCM-SHA384 encrypted) ESMTPS; Tue, 04 Mar 2014 00:39:44 +0000 Received: from glazunov.sibelius.xs4all.nl (kettenis@localhost [127.0.0.1]) by glazunov.sibelius.xs4all.nl (8.14.5/8.14.3) with ESMTP id s240dbbp022786; Tue, 4 Mar 2014 01:39:37 +0100 (CET) Received: (from kettenis@localhost) by glazunov.sibelius.xs4all.nl (8.14.5/8.14.3/Submit) id s240db0w008027; Tue, 4 Mar 2014 01:39:37 +0100 (CET) Date: Tue, 04 Mar 2014 00:39:00 -0000 Message-Id: <201403040039.s240db0w008027@glazunov.sibelius.xs4all.nl> From: Mark Kettenis To: stanshebs@earthlink.net CC: gdb-patches@sourceware.org In-reply-to: <53151B5D.5000309@earthlink.net> (message from Stan Shebs on Mon, 03 Mar 2014 16:16:29 -0800) Subject: Re: [PATCH] Doxygenate gdbtypes.h References: <53151B5D.5000309@earthlink.net> X-SW-Source: 2014-03/txt/msg00053.txt.bz2 > 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.