This is the mail archive of the gdb-patches@sourceware.org mailing list for the GDB project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

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


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


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]