From f944d41397fd16377788b34d9f7ecd0261668381 Mon Sep 17 00:00:00 2001
From: Karl Waclawek <kwaclaw@users.sourceforge.net>
Date: Sat, 27 Jul 2002 23:13:16 +0000
Subject: [PATCH] Added documentation to prevent the misunderstanding that led
 to bug #580503: user called parsing functions recursively.

---
 expat/doc/reference.html | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/expat/doc/reference.html b/expat/doc/reference.html
index fc4d4c0b..57b91360 100644
--- a/expat/doc/reference.html
+++ b/expat/doc/reference.html
@@ -638,7 +638,12 @@ freeing any memory associated with <a href="#userdata">UserData</a>.
 </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
-- 
2.40.0