From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 15431 invoked by alias); 11 Feb 2014 19:08:03 -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 15420 invoked by uid 89); 11 Feb 2014 19:08:02 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-1.7 required=5.0 tests=AWL,BAYES_05,RCVD_IN_DNSWL_NONE,RP_MATCHES_RCVD autolearn=ham version=3.3.2 X-HELO: elasmtp-curtail.atl.sa.earthlink.net Received: from elasmtp-curtail.atl.sa.earthlink.net (HELO elasmtp-curtail.atl.sa.earthlink.net) (209.86.89.64) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Tue, 11 Feb 2014 19:08:01 +0000 Received: from [68.96.200.16] (helo=macbook2.local) by elasmtp-curtail.atl.sa.earthlink.net with esmtpa (Exim 4.67) (envelope-from ) id 1WDIgZ-0005nP-FR for gdb-patches@sourceware.org; Tue, 11 Feb 2014 14:07:59 -0500 Message-ID: <52FA7509.4010400@earthlink.net> Date: Tue, 11 Feb 2014 19:08: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] Use Doxygen for internals documentation References: <52F420E0.9050203@earthlink.net> In-Reply-To: <52F420E0.9050203@earthlink.net> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-ELNK-Trace: ae6f8838ff913eba0cc1426638a40ef67e972de0d01da9407e692d6862cfca1953db176aa6d81df2350badd9bab72f9c350badd9bab72f9c350badd9bab72f9c X-IsSubscribed: yes X-SW-Source: 2014-02/txt/msg00359.txt.bz2 On 2/6/14 3:55 PM, Stan Shebs wrote: > Here is the official patch for the introduction of Doxygen that I > proposed last fall. This is now pushed. I've added http://sourceware.org/gdb/wiki/DoxygenForGDB as the initial info on what to do with it. I've also got defs.h, minsyms.h, and utils.[hc] in various states of doxygenation, but won't spend a whole lot more time on them before pushing them. For other popular header files, I suggest that if people want to jump on any, that we use the wiki page as a simple reservation system - although basic doxygenation of a file need take only a few minutes, one invariably sees many ways to fix up the comment blocks. Have fun! Stan stan@codesourcery.com