From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 15770 invoked by alias); 25 Jun 2007 19:48:52 -0000 Received: (qmail 15762 invoked by uid 22791); 25 Jun 2007 19:48:51 -0000 X-Spam-Check-By: sourceware.org Received: from exprod8og52.obsmtp.com (HELO exprod8og52.obsmtp.com) (64.18.3.86) by sourceware.org (qpsmtpd/0.31) with SMTP; Mon, 25 Jun 2007 19:48:49 +0000 Received: from source ([12.110.134.31]) by exprod8ob52.obsmtp.com ([64.18.7.12]) with SMTP; Mon, 25 Jun 2007 12:47:13 PDT Received: from pkoning.equallogic.com.equallogic.com ([172.25.202.120]) by M31.equallogic.com with Microsoft SMTPSVC(6.0.3790.1830); Mon, 25 Jun 2007 15:48:29 -0400 MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Message-ID: <18048.7178.168032.6683@pkoning.equallogic.com> Date: Mon, 25 Jun 2007 19:48:00 -0000 From: Paul Koning To: dewar@adacore.com Cc: jimb@codesourcery.com, eager@eagercon.com, stanshebs@earthlink.net, gdb@sources.redhat.com Subject: Re: What's an annex? stratum? References: <467D5FEF.7010900@eagercon.com> <467D6D1F.7090507@earthlink.net> <467D6FB8.4080909@eagercon.com> <468009EA.4040504@eagercon.com> <18048.5444.903092.843811@pkoning.equallogic.com> <20070625193135.GA6391@caradoc.them.org> <4680199F.7020906@adacore.com> X-Mailer: VM 7.17 under 21.4 (patch 19) "Constant Variable" XEmacs Lucid X-IsSubscribed: yes 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 X-SW-Source: 2007-06/txt/msg00259.txt.bz2 >>>>> "Robert" == Robert Dewar writes: Robert> On Mon, Jun 25, 2007 at 03:19:32PM -0400, Paul Koning wrote: >> That's really unfortunate. Comments in code are useful but they >> are no substitute for properly written internals documentation. Robert> I disagree, properly arranged comments in the code can most Robert> certainly serve as internals documentation, and have a FAR Robert> better chance of being kept up to date. I am opposed to Robert> having separate internals documentation, I think it is much Robert> better to have this in the source files. Usual practice is for source comments to be local explanation, not global explanation. But in any case, if internals documentation existed in the sources, I'd be a happy camper. paul