From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 26962 invoked by alias); 8 Aug 2013 23:03:13 -0000 Mailing-List: contact gdb-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-owner@sourceware.org Received: (qmail 26944 invoked by uid 89); 8 Aug 2013 23:03:12 -0000 X-Spam-SWARE-Status: No, score=-2.7 required=5.0 tests=AWL,BAYES_00,KHOP_THREADED,RCVD_IN_DNSWL_NONE,RCVD_IN_HOSTKARMA_YE,RDNS_NONE autolearn=no version=3.3.1 Received: from Unknown (HELO elasmtp-banded.atl.sa.earthlink.net) (209.86.89.70) by sourceware.org (qpsmtpd/0.84/v0.84-167-ge50287c) with ESMTP; Thu, 08 Aug 2013 23:03:11 +0000 Received: from [68.96.200.16] (helo=macbook2.local) by elasmtp-banded.atl.sa.earthlink.net with esmtpa (Exim 4.67) (envelope-from ) id 1V7ZEU-0005Vg-G8; Thu, 08 Aug 2013 19:03:02 -0400 Message-ID: <520423A2.6010304@earthlink.net> Date: Thu, 08 Aug 2013 23:03:00 -0000 From: Stan Shebs User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.7; rv:17.0) Gecko/20130801 Thunderbird/17.0.8 MIME-Version: 1.0 To: Eli Zaretskii CC: Doug Evans , gdb@sourceware.org Subject: Re: A new strategy for internals documentation References: <5201781A.3000607@earthlink.net> <83k3jyunt8.fsf@gnu.org> <5202A6D6.8090908@earthlink.net> <83li4ct7ot.fsf@gnu.org> <8361vfu9t4.fsf@gnu.org> In-Reply-To: <8361vfu9t4.fsf@gnu.org> Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit X-ELNK-Trace: ae6f8838ff913eba0cc1426638a40ef67e972de0d01da94077c6ebc6173154a53b6e58edf17e9640350badd9bab72f9c350badd9bab72f9c350badd9bab72f9c X-SW-Source: 2013-08/txt/msg00033.txt.bz2 I'm not sure what we're arguing at this point, so let me see if I can summarize your views on specific actions: 1. Delete gdbint.texinfo. We're all agreed on this, right? 2. Add pieces of the manual to the wiki. You doubt the value of this. Should we forbid people from adding wiki pages? 3. Introduce an annotation/structured scheme in source code comments. You're skeptical, but not opposed to this, right? 4. Use Doxygen. Are you for or against, or indifferent? (For me Doxygen gets the nod by elimination, if nothing else. In the rather lengthy http://en.wikipedia.org/wiki/Comparison_of_documentation_generators there are not a lot of options that are portable, GPL, etc. LLVM's use of Doxygen, http://llvm.org/doxygen/index.html , seems pretty useful.) Stan stan@codesourcery.com