From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 14867 invoked by alias); 16 Jun 2011 09:15:59 -0000 Received: (qmail 14852 invoked by uid 22791); 16 Jun 2011 09:15:58 -0000 X-SWARE-Spam-Status: No, hits=-1.7 required=5.0 tests=AWL,BAYES_00,MSGID_FROM_MTA_HEADER,T_RP_MATCHES_RCVD X-Spam-Check-By: sourceware.org Received: from mtagate4.uk.ibm.com (HELO mtagate4.uk.ibm.com) (194.196.100.164) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Thu, 16 Jun 2011 09:15:42 +0000 Received: from d06nrmr1507.portsmouth.uk.ibm.com (d06nrmr1507.portsmouth.uk.ibm.com [9.149.38.233]) by mtagate4.uk.ibm.com (8.13.1/8.13.1) with ESMTP id p5G9FeKl000312 for ; Thu, 16 Jun 2011 09:15:40 GMT Received: from d06av02.portsmouth.uk.ibm.com (d06av02.portsmouth.uk.ibm.com [9.149.37.228]) by d06nrmr1507.portsmouth.uk.ibm.com (8.13.8/8.13.8/NCO v10.0) with ESMTP id p5G9FeId2613496 for ; Thu, 16 Jun 2011 10:15:40 +0100 Received: from d06av02.portsmouth.uk.ibm.com (loopback [127.0.0.1]) by d06av02.portsmouth.uk.ibm.com (8.14.4/8.13.1/NCO v10.0 AVout) with ESMTP id p5G9Ferw026114 for ; Thu, 16 Jun 2011 03:15:40 -0600 Received: from tuxmaker.boeblingen.de.ibm.com (tuxmaker.boeblingen.de.ibm.com [9.152.85.9]) by d06av02.portsmouth.uk.ibm.com (8.14.4/8.13.1/NCO v10.0 AVin) with SMTP id p5G9FchO026070 for ; Thu, 16 Jun 2011 03:15:38 -0600 Message-Id: <201106160915.p5G9FchO026070@d06av02.portsmouth.uk.ibm.com> Received: by tuxmaker.boeblingen.de.ibm.com (sSMTP sendmail emulation); Thu, 16 Jun 2011 11:15:38 +0200 Subject: [rfa, doc] Remove warning about "unstable" Target Descriptions format To: gdb-patches@sourceware.org Date: Thu, 16 Jun 2011 09:15:00 -0000 From: "Ulrich Weigand" MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit 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-06/txt/msg00229.txt.bz2 Hello, it was just pointed out to me that the documentation about Target Descriptions still shows a prominent warning that the format of those description is still "under active development" and may change between releases. Now while this may have been true when the warning was originally added (over 4 years ago), at this point I'd certainly consider the basic format to be stable (of course, additional features may get supported via new XML elements over time, but that does not affect backward compatibilty). As the continued presence of that warning may actually have the effect of making people reluctant to implement target descriptions in remote agents, it seems counterproductive to keep the warning. The patch below removes the warning from the doc. Any comments? Bye, Ulrich ChangeLog: * gdb.texinfo (Target Description): Remove warning about possibly unstable format. Index: gdb/doc/gdb.texinfo =================================================================== RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v retrieving revision 1.841 diff -u -p -r1.841 gdb.texinfo --- gdb/doc/gdb.texinfo 3 Jun 2011 15:32:44 -0000 1.841 +++ gdb/doc/gdb.texinfo 16 Jun 2011 09:00:57 -0000 @@ -36368,10 +36368,6 @@ The formal DTD for the traceframe info f @appendix Target Descriptions @cindex target descriptions -@strong{Warning:} target descriptions are still under active development, -and the contents and format may change between @value{GDBN} releases. -The format is expected to stabilize in the future. - One of the challenges of using @value{GDBN} to debug embedded systems is that there are so many minor variants of each processor architecture in use. It is common practice for vendors to start with -- Dr. Ulrich Weigand GNU Toolchain for Linux on System z and Cell BE Ulrich.Weigand@de.ibm.com