expat/doc reference.html,1.73,1.74
"Karl Waclawek" <[email protected]> Sun, 24 Jun 2007 10:21:28 -0700
| Newsgroups | gmane.text.xml.expat.cvs |
|---|---|
| Message-ID | <[email protected]> |
Update of /cvsroot/expat/expat/doc In directory sc8-pr-cvs17:/tmp/cvs-serv11665 Modified Files: reference.html Log Message: Corrected recommended namespace separators - reported in bug #1742315. Index: reference.html =================================================================== RCS file: /cvsroot/expat/expat/doc/reference.html,v retrieving revision 1.73 retrieving revision 1.74 diff -u -d -r1.73 -r1.74 --- reference.html 5 Jun 2007 15:05:17 -0000 1.73 +++ reference.html 24 Jun 2007 17:21:25 -0000 1.74 @@ -917,12 +917,15 @@ 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