From e849b49406c04e371da2289da31f2e63044cd32a Mon Sep 17 00:00:00 2001
From: Peter Eisentraut <peter_e@gmx.net>
Date: Tue, 29 Jun 2010 00:03:39 +0000
Subject: [PATCH] Add note clarifying that XML fragments don't accept DTDs
per complaint from Craig Ringer
---
doc/src/sgml/datatype.sgml | 13 ++++++++++++-
1 file changed, 12 insertions(+), 1 deletion(-)
diff --git a/doc/src/sgml/datatype.sgml b/doc/src/sgml/datatype.sgml
index 59a46ad0a3a..42907791ca9 100644
--- a/doc/src/sgml/datatype.sgml
+++ b/doc/src/sgml/datatype.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/datatype.sgml,v 1.248 2010/04/03 07:22:53 petere Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/datatype.sgml,v 1.249 2010/06/29 00:03:39 petere Exp $ -->
<chapter id="datatype">
<title>Data Types</title>
@@ -3985,6 +3985,17 @@ SET xmloption TO { DOCUMENT | CONTENT };
The default is <literal>CONTENT</literal>, so all forms of XML
data are allowed.
</para>
+
+ <note>
+ <para>
+ With the default XML option setting, you cannot directly cast
+ character strings to type <type>xml</type> if they contain a
+ document type declaration, because the definition of XML content
+ fragment does not accept them. If you need to do that, either
+ use <literal>XMLPARSE</literal> or change the XML option.
+ </para>
+ </note>
+
</sect2>
<sect2>
--
GitLab