From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 10915 invoked by alias); 13 Mar 2014 02:38:47 -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 10903 invoked by uid 89); 13 Mar 2014 02:38:46 -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,T_RP_MATCHES_RCVD autolearn=ham version=3.3.2 X-HELO: elasmtp-spurfowl.atl.sa.earthlink.net Received: from elasmtp-spurfowl.atl.sa.earthlink.net (HELO elasmtp-spurfowl.atl.sa.earthlink.net) (209.86.89.66) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Thu, 13 Mar 2014 02:38:45 +0000 Received: from [68.96.200.16] (helo=macbook2.local) by elasmtp-spurfowl.atl.sa.earthlink.net with esmtpa (Exim 4.67) (envelope-from ) id 1WNvXf-0000i3-7H for gdb-patches@sourceware.org; Wed, 12 Mar 2014 22:38:43 -0400 Message-ID: <53211A2E.2020204@earthlink.net> Date: Thu, 13 Mar 2014 02:38: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> In-Reply-To: <53151B5D.5000309@earthlink.net> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-ELNK-Trace: ae6f8838ff913eba0cc1426638a40ef67e972de0d01da9407dff21526d4c43cb99717a2d57f17825350badd9bab72f9c350badd9bab72f9c350badd9bab72f9c X-IsSubscribed: yes X-SW-Source: 2014-03/txt/msg00309.txt.bz2 On 3/3/14 4:16 PM, Stan Shebs wrote: > 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. This is now pushed. Stan stan@codesourcery.com