From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 3091 invoked by alias); 26 Oct 2011 08:10:04 -0000 Received: (qmail 3024 invoked by uid 22791); 26 Oct 2011 08:10:02 -0000 X-SWARE-Spam-Status: No, hits=-2.3 required=5.0 tests=AWL,BAYES_00,RP_MATCHES_RCVD X-Spam-Check-By: sourceware.org Received: from fencepost.gnu.org (HELO fencepost.gnu.org) (140.186.70.10) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Wed, 26 Oct 2011 08:09:48 +0000 Received: from eliz by fencepost.gnu.org with local (Exim 4.71) (envelope-from ) id 1RIyYU-0004Vf-J8; Wed, 26 Oct 2011 04:09:46 -0400 Date: Wed, 26 Oct 2011 13:28:00 -0000 Message-Id: From: Eli Zaretskii To: Stan Shebs CC: gdb-patches@sourceware.org In-reply-to: <4EA753C4.60408@mentor.com> (message from Stan Shebs on Tue, 25 Oct 2011 17:26:44 -0700) Subject: Re: Status of 'blacklist' patch? Reply-to: Eli Zaretskii References: <4E8DCE67.80507@earthlink.net> <4E92E639.7000402@earthlink.net> <83ipnjs9i1.fsf@gnu.org> <83ipndc92n.fsf@gnu.org> <83ehy0ded8.fsf@gnu.org> <4EA753C4.60408@mentor.com> X-IsSubscribed: yes Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org X-SW-Source: 2011-10/txt/msg00693.txt.bz2 > Date: Tue, 25 Oct 2011 17:26:44 -0700 > From: Stan Shebs > > > There's a cost to a comment like this; it's not useful to most > > readers, but they have to parse it anyway. (What the heck does "skip > > function file" mean?) > > Another purpose for having niggling details in the manual is that in the > absence of a formal specification, the manual is our promise to users of > what they should expect to work, and how it will work. So users find > themselves referring to the manual when they try something that seems > obvious, and are surprised that it doesn't work as expected. I know _I_ always consult the manual (not only for GDB), because I never remember enough details, especially subtle and obscure ones. Anyway, if Justin is opposed to adding this comment, I can always do it myself later.