diff --git a/expat/doc/reference.html b/expat/doc/reference.html
index a315870d..c5f6c2c9 100644
--- a/expat/doc/reference.html
+++ b/expat/doc/reference.html
@@ -917,12 +917,15 @@ XML_ParserCreateNS(const XML_Char *encoding,
Constructs a new parser that has namespace processing in effect. Namespace
expanded element names and attribute names are returned as a concatenation
of the namespace URI, sep, and the local part of the name. This
-means that you should pick a character for sep that can't be
-part of a legal URI. There is a special case when sep is the null
-character '\0'
: the namespace URI and the local part will be
-concatenated without any separator - this is intended to support RDF processors.
-It is a programming error to use the null separator with
-namespace triplets.
+means that you should pick a character for sep that can't be part
+of an URI. Since Expat does not check namespace URIs for conformance, the
+only safe choice for a namespace separator is a character that is illegal
+in XML. For instance, '\xFF'
is not legal in UTF-8, and
+'\xFFFF'
is not legal in UTF-16. There is a special case when
+sep is the null character '\0'
: the namespace URI and
+the local part will be concatenated without any separator - this is intended
+to support RDF processors. It is a programming error to use the null separator
+with namespace triplets.
XML_Parser XMLCALL