From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gdb-patches-return-56131-listarch-gdb-patches=sources.redhat.com@sourceware.org>
Received: (qmail 26358 invoked by alias); 17 May 2008 13:53:55 -0000
Received: (qmail 26345 invoked by uid 22791); 17 May 2008 13:53:53 -0000
X-Spam-Check-By: sourceware.org
Received: from mtaout5.012.net.il (HELO mtaout5.012.net.il) (84.95.2.13)     by sourceware.org (qpsmtpd/0.31) with ESMTP; Sat, 17 May 2008 13:53:34 +0000
Received: from HOME-C4E4A596F7 ([83.130.255.47]) by i_mtaout5.012.net.il (HyperSendmail v2004.12) with ESMTPA id <0K1000BOKN8OYTF3@i_mtaout5.012.net.il> for gdb-patches@sources.redhat.com; Sat, 17 May 2008 17:07:37 +0300 (IDT)
Date: Sat, 17 May 2008 21:18:00 -0000
From: Eli Zaretskii <eliz@gnu.org>
Subject: Re: [PATCH] New annotation for threads
In-reply-to: <18478.48682.13900.951343@kahikatea.snap.net.nz>
X-012-Sender: halo1@inter.net.il
To: Nick Roberts <nickrob@snap.net.nz>
Cc: brobecker@adacore.com, gdb-patches@sources.redhat.com
Reply-to: Eli Zaretskii <eliz@gnu.org>
Message-id: <ufxshhwap.fsf@gnu.org>
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> <u4p9hxa31.fsf@gnu.org> <18478.48682.13900.951343@kahikatea.snap.net.nz>
X-IsSubscribed: yes
Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm
Precedence: bulk
List-Id: <gdb-patches.sourceware.org>
List-Subscribe: <mailto:gdb-patches-subscribe@sourceware.org>
List-Archive: <http://sourceware.org/ml/gdb-patches/>
List-Post: <mailto:gdb-patches@sourceware.org>
List-Help: <mailto:gdb-patches-help@sourceware.org>, <http://sourceware.org/ml/#faqs>
Sender: gdb-patches-owner@sourceware.org
X-SW-Source: 2008-05/txt/msg00532.txt.bz2

> From: Nick Roberts <nickrob@snap.net.nz>
> Date: Sat, 17 May 2008 23:14:50 +1200
> Cc: brobecker@adacore.com, gdb-patches@sources.redhat.com
> 
> 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.

> 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.