diff options
author | kwaclaw <kwaclaw> | 2007-06-24 17:21:25 +0000 |
---|---|---|
committer | kwaclaw <kwaclaw> | 2007-06-24 17:21:25 +0000 |
commit | ccc20b070929c3a0dc96cda45332d6826d242352 (patch) | |
tree | ed98c9a00962bc08301cc9e2f0aac647a6387b9e | |
parent | 969fdffc1d8b3d48ab99dbf0adc47c31d560f587 (diff) | |
download | libexpat-ccc20b070929c3a0dc96cda45332d6826d242352.tar.gz |
Corrected recommended namespace separators - reported in bug #1742315.
-rw-r--r-- | doc/reference.html | 15 |
1 files changed, 9 insertions, 6 deletions
diff --git a/doc/reference.html b/doc/reference.html index a315870..c5f6c2c 100644 --- a/doc/reference.html +++ b/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, <em>sep</em>, and the local part of the name. This -means that you should pick a character for <em>sep</em> that can't be -part of a legal URI. There is a special case when <em>sep</em> is the null -character <code>'\0'</code>: 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 -<a href= "#XML_SetReturnNSTriplet">namespace triplets</a>.</div> +means that you should pick a character for <em>sep</em> 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, <code>'\xFF'</code> is not legal in UTF-8, and +<code>'\xFFFF'</code> is not legal in UTF-16. There is a special case when +<em>sep</em> is the null character <code>'\0'</code>: 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 <a href= "#XML_SetReturnNSTriplet">namespace triplets</a>.</div> <pre class="fcndec" id="XML_ParserCreate_MM"> XML_Parser XMLCALL |