From 42e7f0e07eb20e24de1e03f56f3ce53b11512bff Mon Sep 17 00:00:00 2001
From: Tom Lane <tgl@sss.pgh.pa.us>
Date: Wed, 10 Jun 2009 20:25:41 +0000
Subject: [PATCH] Add warning that xpath() doesn't work with non-UTF8 data.

---
 doc/src/sgml/datatype.sgml | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/doc/src/sgml/datatype.sgml b/doc/src/sgml/datatype.sgml
index c944d8f5c4..4f64e054fb 100644
--- a/doc/src/sgml/datatype.sgml
+++ b/doc/src/sgml/datatype.sgml
@@ -3958,6 +3958,14 @@ SET xmloption TO { DOCUMENT | CONTENT };
     processed in UTF-8, computations will be most efficient if the
     server encoding is also UTF-8.
    </para>
+
+   <caution>
+    <para>
+     Some XML-related functions may not work at all on non-ASCII data
+     when the server encoding is not UTF-8.  This is known to be an
+     issue for <function>xpath()</> in particular.
+    </para>
+   </caution>
    </sect2>
 
    <sect2>
-- 
2.39.5