From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gdb-return-28912-listarch-gdb=sources.redhat.com@sourceware.org>
Received: (qmail 17840 invoked by alias); 25 Jun 2007 20:44:07 -0000
Received: (qmail 17831 invoked by uid 22791); 25 Jun 2007 20:44:07 -0000
X-Spam-Check-By: sourceware.org
Received: from rock.gnat.com (HELO rock.gnat.com) (205.232.38.15)     by sourceware.org (qpsmtpd/0.31) with ESMTP; Mon, 25 Jun 2007 20:44:03 +0000
Received: from localhost (localhost.localdomain [127.0.0.1]) 	by filtered-rock.gnat.com (Postfix) with ESMTP id 921A42A9BE3; 	Mon, 25 Jun 2007 16:44:01 -0400 (EDT)
Received: from rock.gnat.com ([127.0.0.1]) 	by localhost (rock.gnat.com [127.0.0.1]) (amavisd-new, port 10024) 	with LMTP id 6MApFF+6XwFX; Mon, 25 Jun 2007 16:44:01 -0400 (EDT)
Received: from [127.0.0.1] (nile.gnat.com [205.232.38.5]) 	by rock.gnat.com (Postfix) with ESMTP id 4F80C2A9BD5; 	Mon, 25 Jun 2007 16:44:01 -0400 (EDT)
Message-ID: <46802911.7070209@adacore.com>
Date: Mon, 25 Jun 2007 20:44:00 -0000
From: Robert Dewar <dewar@adacore.com>
User-Agent: Thunderbird 1.5.0.12 (Windows/20070509)
MIME-Version: 1.0
To: Eli Zaretskii <eliz@gnu.org>
CC:  pkoning@equallogic.com,  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> <m3tzsvsyh0.fsf@codesourcery.com> <468009EA.4040504@eagercon.com> <m3sl8f6eab.fsf@codesourcery.com> <18048.5444.903092.843811@pkoning.equallogic.com> <20070625193135.GA6391@caradoc.them.org> <4680199F.7020906@adacore.com> <uk5trojxj.fsf@gnu.org>
In-Reply-To: <uk5trojxj.fsf@gnu.org>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
X-IsSubscribed: yes
Mailing-List: contact gdb-help@sourceware.org; run by ezmlm
Precedence: bulk
List-Id: <gdb.sourceware.org>
List-Subscribe: <mailto:gdb-subscribe@sourceware.org>
List-Archive: <http://sourceware.org/ml/gdb/>
List-Post: <mailto:gdb@sourceware.org>
List-Help: <mailto:gdb-help@sourceware.org>, <http://sourceware.org/ml/#faqs>
Sender: gdb-owner@sourceware.org
X-SW-Source: 2007-06/txt/msg00270.txt.bz2

Eli Zaretskii wrote:

> In any case, if people here believe comments are a reasonable
> substitute for documentation, perhaps I should from now on reject code
> patches that do not explain themselves clearly, and do not contain
> enough references to other related portions of GDB.

You should do that in *any* case, inadequately documented code
is never acceptable.