From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 30912 invoked by alias); 14 Apr 2003 21:33:41 -0000 Mailing-List: contact gdb-help@sources.redhat.com; run by ezmlm Precedence: bulk List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-owner@sources.redhat.com Received: (qmail 30901 invoked from network); 14 Apr 2003 21:33:40 -0000 Received: from unknown (HELO takamaka.act-europe.fr) (205.232.38.116) by sources.redhat.com with SMTP; 14 Apr 2003 21:33:40 -0000 Received: by takamaka.act-europe.fr (Postfix, from userid 507) id 7F61ED34B8; Mon, 14 Apr 2003 17:33:40 -0400 (EDT) Date: Mon, 14 Apr 2003 21:33:00 -0000 From: Joel Brobecker To: Doug Evans Cc: Matt Thomas , gdb@sources.redhat.com Subject: Re: breakpoint commands and finish Message-ID: <20030414213340.GJ1151@gnat.com> References: <5.1.1.6.2.20030414135022.04175790@3am-software.com> <20030414210028.GG1151@gnat.com> <20030414210431.GI1151@gnat.com> <16027.9155.65780.337875@casey.transmeta.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <16027.9155.65780.337875@casey.transmeta.com> User-Agent: Mutt/1.4i X-SW-Source: 2003-04/txt/msg00138.txt.bz2 > fwiw, over time one hopes documentation gets larger and larger. > This has the consequence of reducing the signal/noise ratio of > "RTFM" more and more. Generally speaking, I can only agree with you. One of the nice things about GDB is that the maintainers take the documentation very seriously and any new feature is documented. However, in this particular case, I think that it was very easy to find the information. The person was asking what the behavior of a "commands" should be: the answer to his question is right there in the section documenting the commands lists. > It'd be nice if people got in the habit of specifying where exactly > in the documentation to look. e.g. I disagree, unless the information is buried somewhere not obvious. One very important lesson I learnt at university is how to find the information myself. In this particular cases, all you have to do is check the index, click on the name of the command you are interested in "commands" in that case, and voila! The answer is right there. I believe that actually letting people search themselves the location of the information they are looking for is helpful. (BTW: I did give the answer to the question when it was asked a few days ago) -- Joel