diff options
Diffstat (limited to 'doc/html/xml.html')
| -rw-r--r-- | doc/html/xml.html | 24 |
1 files changed, 12 insertions, 12 deletions
diff --git a/doc/html/xml.html b/doc/html/xml.html index a165654b9..0ba798f0c 100644 --- a/doc/html/xml.html +++ b/doc/html/xml.html @@ -286,30 +286,30 @@ attributes starting with <em>xmlns:</em>) are reported. name="Eris Kallisti"/> </pre> -With <em>http://xml.org/sax/features/namespace-prefixes</em> set to TRUE -the reader will report four attributes; but with the <em>namespace-prefixes</em> feature set to FALSE only three, with the <em>xmlns:fnord</em> attribute defining a namespace being "invisible" to the +With <em>http://xml.org/sax/features/namespace-prefixes</em> set to true +the reader will report four attributes; but with the <em>namespace-prefixes</em> feature set to false only three, with the <em>xmlns:fnord</em> attribute defining a namespace being "invisible" to the reader. <p> The <em>http://xml.org/sax/features/namespaces</em> feature is responsible -for reporting local names, namespace prefixes and URIs. With <em>http://xml.org/sax/features/namespaces</em> set to TRUE the parser will +for reporting local names, namespace prefixes and URIs. With <em>http://xml.org/sax/features/namespaces</em> set to true the parser will report <em>title</em> as the local name of the <em>fnord:title</em> attribute, <em>fnord</em> being the namespace prefix and <em>http://trolltech.com/fnord/</em> as the namespace URI. When <em>http://xml.org/sax/features/namespaces</em> is -FALSE none of them are reported. +false none of them are reported. <p> In the current implementation the TQt XML classes follow the definition that the prefix <em>xmlns</em> itself isn't associated with any namespace at all (see <a href="http://www.w3.org/TR/1999/REC-xml-names-19990114/#ns-using">http://www.w3.org/TR/1999/REC-xml-names-19990114/#ns-using</a>). Therefore even with <em>http://xml.org/sax/features/namespaces</em> and -<em>http://xml.org/sax/features/namespace-prefixes</em> both set to TRUE +<em>http://xml.org/sax/features/namespace-prefixes</em> both set to true the reader won't return either a local name, a namespace prefix or a namespace URI for <em>xmlns:fnord</em>. <p> This might be changed in the future following the W3C suggestion <a href="http://www.w3.org/2000/xmlns/">http://www.w3.org/2000/xmlns/</a> to associate <em>xmlns</em> with the namespace <em>http://www.w3.org/2000/xmlns</em>. <p> As the SAX2 standard suggests, <a href="tqxmlsimplereader.html">TQXmlSimpleReader</a> defaults to having -<em>http://xml.org/sax/features/namespaces</em> set to TRUE and -<em>http://xml.org/sax/features/namespace-prefixes</em> set to FALSE. +<em>http://xml.org/sax/features/namespaces</em> set to true and +<em>http://xml.org/sax/features/namespace-prefixes</em> set to false. When changing this behavior using <a href="tqxmlsimplereader.html#setFeature">TQXmlSimpleReader::setFeature</a>() note that the combination of both features set to -FALSE is illegal. +false is illegal. <p> For a practical demonstration of how the two features affect the output of the reader run the <a href="tagreader-with-features-example.html">tagreader with features example.</a> <p> <a name="sax2NamespacesSummary"></a> @@ -322,10 +322,10 @@ output of the reader run the <a href="tagreader-with-features-example.html">tagr <th valign="top">Qualified names <th valign="top">Prefix mapping <th valign="top">xmlns attributes -<tr bgcolor="#f0f0f0"> <td valign="top">(TRUE, FALSE) <td valign="top">Yes <td valign="top">Yes* <td valign="top">Yes <td valign="top">No -<tr bgcolor="#d0d0d0"> <td valign="top">(TRUE, TRUE) <td valign="top">Yes <td valign="top">Yes <td valign="top">Yes <td valign="top">Yes -<tr bgcolor="#f0f0f0"> <td valign="top">(FALSE, TRUE) <td valign="top">No* <td valign="top">Yes <td valign="top">No* <td valign="top">Yes -<tr bgcolor="#d0d0d0"> <td valign="top">(FALSE, FALSE) <td valign="top" colspan="4" rowspan="1"> Illegal +<tr bgcolor="#f0f0f0"> <td valign="top">(true, false) <td valign="top">Yes <td valign="top">Yes* <td valign="top">Yes <td valign="top">No +<tr bgcolor="#d0d0d0"> <td valign="top">(true, true) <td valign="top">Yes <td valign="top">Yes <td valign="top">Yes <td valign="top">Yes +<tr bgcolor="#f0f0f0"> <td valign="top">(false, true) <td valign="top">No* <td valign="top">Yes <td valign="top">No* <td valign="top">Yes +<tr bgcolor="#d0d0d0"> <td valign="top">(false, false) <td valign="top" colspan="4" rowspan="1"> Illegal </table></center> <p> <sup>*</sup> The behavior of these entries is not specified by SAX. <p> <a name="sax2Properties"></a> |