From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 17036 invoked by alias); 25 Jun 2007 20:42:35 -0000 Received: (qmail 17027 invoked by uid 22791); 25 Jun 2007 20:42:34 -0000 X-Spam-Check-By: sourceware.org Received: from nitzan.inter.net.il (HELO nitzan.inter.net.il) (213.8.233.22) by sourceware.org (qpsmtpd/0.31) with ESMTP; Mon, 25 Jun 2007 20:42:33 +0000 Received: from HOME-C4E4A596F7 (IGLD-80-230-162-148.inter.net.il [80.230.162.148]) by nitzan.inter.net.il (MOS 3.7.3a-GA) with ESMTP id HBQ30512 (AUTH halo1); Mon, 25 Jun 2007 23:42:36 +0300 (IDT) Date: Mon, 25 Jun 2007 20:42:00 -0000 Message-Id: From: Eli Zaretskii To: Paul Koning CC: jimb@codesourcery.com, eager@eagercon.com, stanshebs@earthlink.net, gdb@sources.redhat.com In-reply-to: <18048.5444.903092.843811@pkoning.equallogic.com> (message from Paul Koning on Mon, 25 Jun 2007 15:19:32 -0400) Subject: Re: What's an annex? stratum? Reply-to: Eli Zaretskii References: <467D5FEF.7010900@eagercon.com> <467D6D1F.7090507@earthlink.net> <467D6FB8.4080909@eagercon.com> <468009EA.4040504@eagercon.com> <18048.5444.903092.843811@pkoning.equallogic.com> 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/msg00269.txt.bz2 > Date: Mon, 25 Jun 2007 15:19:32 -0400 > From: Paul Koning > Cc: eager@eagercon.com, stanshebs@earthlink.net, gdb@sources.redhat.com > > Jim> I'm even a little skeptical about the value of internals > Jim> documentation at all. It seems to me that explanations like > Jim> that belong in the code, where people are more likely to see > Jim> them, keep them up to date, and delete them when appropriate. > > That's really unfortunate. Comments in code are useful but they are > no substitute for properly written internals documentation. 110% agreement. But then I'm the guy responsible for the GDB documentation.