From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 2412 invoked by alias); 17 May 2008 21:18:09 -0000 Received: (qmail 2404 invoked by uid 22791); 17 May 2008 21:18:08 -0000 X-Spam-Check-By: sourceware.org Received: from viper.snap.net.nz (HELO viper.snap.net.nz) (202.37.101.25) by sourceware.org (qpsmtpd/0.31) with ESMTP; Sat, 17 May 2008 21:17:40 +0000 Received: from kahikatea.snap.net.nz (204.61.255.123.dynamic.snap.net.nz [123.255.61.204]) by viper.snap.net.nz (Postfix) with ESMTP id D471A3DA1B4; Sun, 18 May 2008 09:17:37 +1200 (NZST) Received: by kahikatea.snap.net.nz (Postfix, from userid 1000) id 6E9CB8FC6D; Sun, 18 May 2008 09:17:30 +1200 (NZST) From: Nick Roberts MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Message-ID: <18479.19305.331413.57595@kahikatea.snap.net.nz> Date: Mon, 19 May 2008 09:09:00 -0000 To: Eli Zaretskii Cc: brobecker@adacore.com, gdb-patches@sources.redhat.com Subject: Re: [PATCH] New annotation for threads In-Reply-To: References: <18440.29531.916381.569346@kahikatea.snap.net.nz> <20080429023735.GD841@adacore.com> <18454.43094.168458.742737@kahikatea.snap.net.nz> <20080501181758.GD3801@adacore.com> <18458.21177.959458.278174@kahikatea.snap.net.nz> <20080501233703.GF3801@adacore.com> <18458.23326.25887.70597@kahikatea.snap.net.nz> <18478.48682.13900.951343@kahikatea.snap.net.nz> X-Mailer: VM 7.19 under Emacs 22.2.50.2 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: 2008-05/txt/msg00541.txt.bz2 > > Documenting a feature helps and encourages it's use. > > Then you should submit a patch to remove all docs of annotations from > the manual, and try to convince us to accept it. Not documenting just > one piece is inconsistent and doesn't make sense. The difference, of course, is that all the current documentation was presumably written before annotations were deprecated and before MI existed. Indeed, a long time ago Andrew Cagney moved the description for most annotations out of the GDB manual into a separate file called annotate.texinfo. > > For this reason, and because annotations is deprecated, I was > > intending not to document it. Why do you think it should be > > documented? > > Because annotations are generally documented, and because they are > still part of GDB. As long as annotations are part of GDB, I will > object to any user-visible change in them that is not documented in > the manual. I will do this then as it will be easier to document it than try to argue that it's not desirable. -- Nick http://www.inet.net.nz/~nickrob