From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 30251 invoked by alias); 25 Jun 2007 18:03:44 -0000 Received: (qmail 30243 invoked by uid 22791); 25 Jun 2007 18:03:44 -0000 X-Spam-Check-By: sourceware.org Received: from mail.codesourcery.com (HELO mail.codesourcery.com) (65.74.133.4) by sourceware.org (qpsmtpd/0.31) with ESMTP; Mon, 25 Jun 2007 18:03:42 +0000 Received: (qmail 26591 invoked from network); 25 Jun 2007 18:03:40 -0000 Received: from unknown (HELO localhost) (jimb@127.0.0.2) by mail.codesourcery.com with ESMTPA; 25 Jun 2007 18:03:40 -0000 To: Michael Eager Cc: Stan Shebs , gdb@sources.redhat.com Subject: Re: What's an annex? stratum? References: <467D5FEF.7010900@eagercon.com> <467D6D1F.7090507@earthlink.net> <467D6FB8.4080909@eagercon.com> From: Jim Blandy Date: Mon, 25 Jun 2007 18:03:00 -0000 In-Reply-To: <467D6FB8.4080909@eagercon.com> (Michael Eager's message of "Sat, 23 Jun 2007 12:08:40 -0700") Message-ID: User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/22.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii 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/msg00243.txt.bz2 Michael Eager writes: > Stan Shebs wrote: >> Michael Eager wrote: >>> Looking at target.c, I see some terms which are less >>> than clear: annex and stratum. Could someone tell me >>> what these mean? >> "Annex" is apparently an introduction of Andrew's from 2004, does >> kind of look like an address space addition, although not clear that >> it's fully implemented. > > I'm assuming that the XML target description in the docs is similarly > incomplete and/or obsolete. > > There seems to be a fair amount of cruft in the code, and > even more in the documentation. Sigh. For what it's worth --- we don't invest enough time in doc/gdbint.texinfo to keep it a clear, accurate reference to the code. (For me, at least, this is a deliberate decision.) It's more a collection of the clearer explanations that have appeared on the mailing list over time. gdb.texinfo, however, is supposed to be complete, accurate, and clear.