diff options
| author | Tom Lane <tgl@sss.pgh.pa.us> | 2016-11-04 18:29:53 -0400 |
|---|---|---|
| committer | Tom Lane <tgl@sss.pgh.pa.us> | 2016-11-04 18:29:53 -0400 |
| commit | 20540710e83f2873707c284a0c0693f0b57156c4 (patch) | |
| tree | 5cb4cfcd0c07a754b370647baabaffa32d756115 /doc/src | |
| parent | d5f6f13f8e7eb1c28395807922246294da4f57bb (diff) | |
Delete contrib/xml2's legacy implementation of xml_is_well_formed().
This function is unreferenced in modern usage; it was superseded in 9.1
by a core function of the same name. It has been left in place in the C
code only so that pre-9.1 SQL definitions of the contrib/xml2 functions
would continue to work. Six years seems like enough time for people to
have updated to the extension-style version of the xml2 module, so let's
drop this.
The key reason for not keeping it any longer is that we want to stick
an explicit PGDLLEXPORT into PG_FUNCTION_INFO_V1(), and the similarity
of name to the core function creates a conflict that compilers will
complain about.
Extracted from a larger patch for that purpose. I'm committing this
change separately to give it more visibility in the commit logs.
While at it, remove the documentation entry that claimed that
xml_is_well_formed() is a function provided by contrib/xml2, and
instead mention the even more ancient alias xml_valid().
Laurenz Albe, doc change by me
Patch: <A737B7A37273E048B164557ADEF4A58B53962ED8@ntex2010a.host.magwien.gv.at>
Diffstat (limited to 'doc/src')
| -rw-r--r-- | doc/src/sgml/xml2.sgml | 10 |
1 files changed, 5 insertions, 5 deletions
diff --git a/doc/src/sgml/xml2.sgml b/doc/src/sgml/xml2.sgml index a40172c36d2..9bbc9e75d78 100644 --- a/doc/src/sgml/xml2.sgml +++ b/doc/src/sgml/xml2.sgml @@ -53,7 +53,7 @@ <row> <entry> <function> - xml_is_well_formed(document) + xml_valid(document) </function> </entry> <entry> @@ -62,10 +62,10 @@ <entry> <para> This parses the document text in its parameter and returns true if the - document is well-formed XML. (Note: before PostgreSQL 8.2, this - function was called <function>xml_valid()</>. That is the wrong name - since validity and well-formedness have different meanings in XML. - The old name is still available, but is deprecated.) + document is well-formed XML. (Note: this is an alias for the standard + PostgreSQL function <function>xml_is_well_formed()</>. The + name <function>xml_valid()</> is technically incorrect since validity + and well-formedness have different meanings in XML.) </para> </entry> </row> |