diff options
Diffstat (limited to 'doc/xml.doc')
| -rw-r--r-- | doc/xml.doc | 24 |
1 files changed, 12 insertions, 12 deletions
diff --git a/doc/xml.doc b/doc/xml.doc index fad7ad5bd..be5bacc2a 100644 --- a/doc/xml.doc +++ b/doc/xml.doc @@ -295,26 +295,26 @@ Consider the following element: fnord:title="Goddess" name="Eris Kallisti"/> \endcode -With \e http://xml.org/sax/features/namespace-prefixes set to TRUE +With \e http://xml.org/sax/features/namespace-prefixes set to true the reader will report four attributes; but with the \e -namespace-prefixes feature set to FALSE only three, with the \e +namespace-prefixes feature set to false only three, with the \e xmlns:fnord attribute defining a namespace being "invisible" to the reader. The \e http://xml.org/sax/features/namespaces feature is responsible for reporting local names, namespace prefixes and URIs. With \e -http://xml.org/sax/features/namespaces set to TRUE the parser will +http://xml.org/sax/features/namespaces set to true the parser will report \e title as the local name of the \e fnord:title attribute, \e fnord being the namespace prefix and \e http://trolltech.com/fnord/ as the namespace URI. When \e http://xml.org/sax/features/namespaces is -FALSE none of them are reported. +false none of them are reported. In the current implementation the TQt XML classes follow the definition that the prefix \e xmlns itself isn't associated with any namespace at all (see \link http://www.w3.org/TR/1999/REC-xml-names-19990114/#ns-using http://www.w3.org/TR/1999/REC-xml-names-19990114/#ns-using \endlink). Therefore even with \e http://xml.org/sax/features/namespaces and -\e http://xml.org/sax/features/namespace-prefixes both set to TRUE +\e http://xml.org/sax/features/namespace-prefixes both set to true the reader won't return either a local name, a namespace prefix or a namespace URI for \e xmlns:fnord. @@ -324,11 +324,11 @@ to associate \e xmlns with the namespace \e http://www.w3.org/2000/xmlns. As the SAX2 standard suggests, \l TQXmlSimpleReader defaults to having -\e http://xml.org/sax/features/namespaces set to TRUE and -\e http://xml.org/sax/features/namespace-prefixes set to FALSE. +\e http://xml.org/sax/features/namespaces set to true and +\e http://xml.org/sax/features/namespace-prefixes set to false. When changing this behavior using \l TQXmlSimpleReader::setFeature() note that the combination of both features set to -FALSE is illegal. +false is illegal. For a practical demonstration of how the two features affect the output of the reader run the \link tagreader-with-features-example.html @@ -345,10 +345,10 @@ tagreader with features example. \endlink \i Qualified names \i Prefix mapping \i xmlns attributes -\row \i (TRUE, FALSE) \i Yes \i Yes* \i Yes \i No -\row \i (TRUE, TRUE) \i Yes \i Yes \i Yes \i Yes -\row \i (FALSE, TRUE) \i No* \i Yes \i No* \i Yes -\row \i (FALSE, FALSE) \i41 Illegal +\row \i (true, false) \i Yes \i Yes* \i Yes \i No +\row \i (true, true) \i Yes \i Yes \i Yes \i Yes +\row \i (false, true) \i No* \i Yes \i No* \i Yes +\row \i (false, false) \i41 Illegal \endtable <sup>*</sup> The behavior of these entries is not specified by SAX. |