diff --git a/expat/doc/reference.html b/expat/doc/reference.html
index 59e43909..d848ab11 100644
--- a/expat/doc/reference.html
+++ b/expat/doc/reference.html
@@ -389,8 +389,8 @@ namespace declaration handlers with
XML_SetNamespaceDeclHandler
.
Element type and attribute names that belong to a given namespace are
-passed to the appropriate handler in expanded form. This expanded form
-is a concatenation of the namespace URI, the separator character (which
+passed to the appropriate handler in expanded form. By default this expanded
+form is a concatenation of the namespace URI, the separator character (which
is the 2nd argument to XML_ParserCreateNS
), and the local
name (i.e. the part after the colon). Names with undeclared prefixes are
passed through to the handlers unchanged, with the prefix and colon still
@@ -398,6 +398,12 @@ attached. Unprefixed attribute names are never expanded, and unprefixed
element names are only expanded when they are in the scope of a default
namespace.
+
However if XML_SetReturnNSTriplet
+has been called with a non-zero do_nst
parameter, then the
+expanded form for names with an explicit prefix is a concatenation of:
+URI, separator, local name, separator, prefix.
+
You can set handlers for the start of a namespace declaration and for
the end of a scope of a declaration with the
XML_SetNamespaceDeclHandler
function.
@@ -1435,5 +1441,25 @@ The choices for code
are:
+
+This function only has an effect when using a parser created with
+XML_ParserCreateNS, i.e. when namespace
+processing is in effect. The do_nst
sets whether or not prefixes
+are returned with names qualified with a namespace prefix. If this function
+is called with do_nst
non-zero, then afterwards namespace
+qualified names (that is qualified with a prefix as opposed to belonging
+to a default namespace) are returned as a triplet with the three parts
+separated by the namespace separator specified when the parser was created.
+The order of returned parts is URI, local name, and prefix.
If do_nst
is zero, then namespaces are reported in the
+default manner, URI then local_name separated by the namespace separator.