From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 15563 invoked by alias); 17 May 2008 13:22:59 -0000 Received: (qmail 15554 invoked by uid 22791); 17 May 2008 13:22:58 -0000 X-Spam-Check-By: sourceware.org Received: from elasmtp-dupuy.atl.sa.earthlink.net (HELO elasmtp-dupuy.atl.sa.earthlink.net) (209.86.89.62) by sourceware.org (qpsmtpd/0.31) with ESMTP; Sat, 17 May 2008 13:22:37 +0000 Received: from [68.108.140.244] (helo=macbook-2.local) by elasmtp-dupuy.atl.sa.earthlink.net with esmtpa (Exim 4.67) (envelope-from ) id 1JxMMo-0007jW-QJ; Sat, 17 May 2008 09:22:31 -0400 Message-ID: <482EDC14.2030506@earthlink.net> Date: Sat, 17 May 2008 19:15:00 -0000 From: Stan Shebs User-Agent: Thunderbird 2.0.0.14 (Macintosh/20080421) MIME-Version: 1.0 To: Nick Roberts CC: Eli Zaretskii , brobecker@adacore.com, gdb-patches@sources.redhat.com Subject: Re: [PATCH] New annotation for threads 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> In-Reply-To: <18478.48682.13900.951343@kahikatea.snap.net.nz> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-ELNK-Trace: ae6f8838ff913eba0cc1426638a40ef67e972de0d01da940bcb188fbbda76e172790f1155e3832e0350badd9bab72f9c350badd9bab72f9c350badd9bab72f9c 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/msg00530.txt.bz2 Nick Roberts wrote: > > Thanks, but please add a corresponding bit to the user manual. The > > existing annotations are described there. > > I plan to represent this patch with a test shortly. Documenting a feature > helps and encourages it's use. For this reason, and because annotations is > deprecated, I was intending not to document it. Why do you think it should be > documented? > If it's in the code and expected to be maintained, then it should be documented. How many times on this list have people been scratching their heads trying to figure out what an undocumented bit of code was supposed to do? These "deprecated" things seem to have a way of lasting longer than anyone's memories. :-) Stan