[rfa, doc] Remove warning about "unstable" Target Descriptions format

[rfa, doc] Remove warning about "unstable" Target Descriptions format

[Ulrich Weigand]

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

Re: [rfa, doc] Remove warning about "unstable" Target Descriptions format

[Tom Tromey]

>>>>> "Ulrich" == Ulrich Weigand <uweigand@de.ibm.com> writes:

Ulrich> The patch below removes the warning from the doc.

Ulrich> Any comments?

I think it seems like a good idea to remove this.

Tom

Re: [rfa, doc] Remove warning about "unstable" Target Descriptions format

[Ulrich Weigand]

Tom Tromey wrote:
> >>>>> "Ulrich" == Ulrich Weigand <uweigand@de.ibm.com> writes:
> 
> Ulrich> The patch below removes the warning from the doc.
> 
> Ulrich> Any comments?
> 
> I think it seems like a good idea to remove this.

Thanks, Tom.  It seems nobody is objecting to this idea ...

Eli, is the doc change OK?

Bye,
Ulrich

-- 
  Dr. Ulrich Weigand
  GNU Toolchain for Linux on System z and Cell BE
  Ulrich.Weigand@de.ibm.com

Re: [rfa, doc] Remove warning about "unstable" Target Descriptions format

[Eli Zaretskii]

> Date: Wed, 29 Jun 2011 14:27:54 +0200 (CEST)
> From: "Ulrich Weigand" <uweigand@de.ibm.com>
> Cc: gdb-patches@sourceware.org
> 
> Tom Tromey wrote:
> > >>>>> "Ulrich" == Ulrich Weigand <uweigand@de.ibm.com> writes:
> > 
> > Ulrich> The patch below removes the warning from the doc.
> > 
> > Ulrich> Any comments?
> > 
> > I think it seems like a good idea to remove this.
> 
> Thanks, Tom.  It seems nobody is objecting to this idea ...
> 
> Eli, is the doc change OK?

Yes, thanks.

Re: [rfa, doc] Remove warning about "unstable" Target Descriptions format

[Ulrich Weigand]

Eli Zaretskii wrote:
> > Date: Wed, 29 Jun 2011 14:27:54 +0200 (CEST)
> > From: "Ulrich Weigand" <uweigand@de.ibm.com>
> > Cc: gdb-patches@sourceware.org
> > 
> > Eli, is the doc change OK?
> 
> Yes, thanks.

Checked in, thanks!

Bye,
Ulrich

-- 
  Dr. Ulrich Weigand
  GNU Toolchain for Linux on System z and Cell BE
  Ulrich.Weigand@de.ibm.com