[Expat-checkins] expat/doc reference.html,1.13,1.14

[kwaclaw@users.sourceforge.net]

Update of /cvsroot/expat/expat/doc
In directory usw-pr-cvs1:/tmp/cvs-serv6909

Modified Files:
	reference.html 
Log Message:
Added documentation to prevent the misunderstanding that led
to bug #580503: user called parsing functions recursively.

Index: reference.html
===================================================================
RCS file: /cvsroot/expat/expat/doc/reference.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- reference.html	11 Jul 2002 03:35:42 -0000	1.13
+++ reference.html	27 Jul 2002 23:13:16 -0000	1.14
@@ -638,7 +638,12 @@
 </div>
 
 <h3><a name="parsing">Parsing</a></h3>
-
+<p>To state the obvious: the three parsing functions <code>XML_Parse</code>,
+<code>XML_ParseBuffer</code> and <code>XML_GetBuffer</code> must not be called
+from within a handler unless they operate on a separate parser instance, that is,
+one that did not call the handler. For example, it is OK to call the parsing
+functions from within an <code>XML_ExternalEntityRefHandler</code>, if they
+apply to the parser created by <code>XML_ExternalEntityParserCreate</code>.</p>
 
 <div class="fcndec"><a name="XML_Parse"><pre>
 int