Add deprecation notice about planned removal in 8.4 and advice to try using

the newer XML stuff in core.

(This should probably also be referred to in the release notes.)

diff --git a/contrib/xml2/README.xml2 b/contrib/xml2/README.xml2
index c2e71703860f7bb7a1e2d2c4231370a2781324f8..28d3db0e006aa9d6a4b652c3e7973f1e6de59d3f 100644 (file)
--- a/contrib/xml2/README.xml2
+++ b/contrib/xml2/README.xml2
@@ -1,6 +1,19 @@
 XML-handling functions for PostgreSQL
 =====================================
 
+    DEPRECATION NOTICE:  From PostgreSQL 8.3 on, there is XML-related
+    functionality based on the SQL/XML standard in the core server.
+    That functionality covers XML syntax checking and XPath queries,
+    which is what this module does as well, and more, but the API is
+    not at all compatible.  It is planned that this module will be
+    removed in PostgreSQL 8.4 in favor of the newer standard API, so
+    you are encouraged to try converting your applications.  If you
+    find that some of the functionality of this module is not
+    available in an adequate form with the newer API, please explain
+    your issue to pgsql-hackers@postgresql.org so that the deficiency
+    can be addressed.
+                                      -- Peter Eisentraut, 2007-05-24
+
 Development of this module was sponsored by Torchbox Ltd. (www.torchbox.com)
 It has the same BSD licence as PostgreSQL.