From 147fc61d3d5384ebf18145dbca066ea5fc4f4fc8 Mon Sep 17 00:00:00 2001
From: kwaclaw <kwaclaw>
Date: Thu, 17 Oct 2002 16:45:49 +0000
Subject: Improved documentation of XML_ExternalEntityRefHandler.

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

(limited to 'doc')

diff --git a/doc/reference.html b/doc/reference.html
index 8cdfcd6..4142ee0 100644
--- a/doc/reference.html
+++ b/doc/reference.html
@@ -1000,6 +1000,12 @@ called for processing an external DTD subset if parameter entity parsing
 is in effect. (See <a href="#XML_SetParamEntityParsing">
 <code>XML_SetParamEntityParsing</code></a>.)</p>
 
+<p>The context parameter specifies the parsing context in the format
+expected by the context argument to XML_ExternalEntityParserCreate.
+context is valid only until the handler returns, so if the
+referenced entity is to be parsed later, it must be copied.
+context is NULL only when the entity is a parameter entity, which
+is how one can differentiate between general and parameter entities.</p>
 
 <p>The base parameter is the base to use for relative system identifiers.
 It is set by <a href="#XML_SetBase">XML_SetBase</a> and may be null. The
-- 
cgit v1.2.1