[Expat-checkins] expat/doc reference.html,1.40,1.41

[Fred L. Drake]

Update of /cvsroot/expat/expat/doc
In directory sc8-pr-cvs1:/tmp/cvs-serv14934

Modified Files:
	reference.html 
Log Message:
Added notes that the namespace decl handlers are only called when the
start element handler is set.  See SF bug #620343.


Index: reference.html
===================================================================
RCS file: /cvsroot/expat/expat/doc/reference.html,v
retrieving revision 1.40
retrieving revision 1.41
diff -u -d -r1.40 -r1.41
--- reference.html	21 Jan 2003 05:00:51 -0000	1.40
+++ reference.html	21 Jan 2003 16:09:31 -0000	1.41
@@ -1154,6 +1154,12 @@
 declarations occur inside start tags. But the namespace declaration start
 handler is called before the start tag handler for each namespace declared
 in that start tag.</p>
+
+<p><strong>Note:</strong>
+Due to limitations of the implementation, the
+StartNamespaceDeclHandler is not called unless the StartElementHandler
+is also set.  The specific value of the StartElementHandler is allowed
+to change freely, so long as it is not NULL.</p>
 </div>
 
 <div class="handler">
@@ -1170,6 +1176,12 @@
 declaration. This will be called, for each namespace declaration,
 after the handler for the end tag of the element in which the
 namespace was declared.</p>
+
+<p><strong>Note:</strong>
+Due to limitations of the implementation, the EndNamespaceDeclHandler
+is not called unless the StartElementHandler is also set.  The
+specific value of the StartElementHandler is allowed to change freely,
+so long as it is not NULL.</p>
 </div>
 
 <div class="handler">
@@ -1179,6 +1191,13 @@
                             XML_EndNamespaceDeclHandler end)
 </pre>
 <p>Sets both namespace declaration handlers with a single call.</p>
+
+<p><strong>Note:</strong>
+Due to limitations of the implementation, the
+StartNamespaceDeclHandler and EndNamespaceDeclHandler are not called
+unless the StartElementHandler is also set.  The specific value of the
+StartElementHandler is allowed to change freely, so long as it is not
+NULL.</p>
 </div>
 
 <div class="handler">