Improved documentation of XML_ExternalEntityRefHandler.

diff --git a/expat/doc/reference.html b/expat/doc/reference.html
index 8cdfcd682857d8a92b4db06f98725f2cf3f16395..4142ee078a78b0f7138a2ab268104e4f5a243efd 100644 (file)
--- a/expat/doc/reference.html
+++ b/expat/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

diff --git a/expat/lib/expat.h b/expat/lib/expat.h
index 5e4b23707c0e37922cd946c751aad4d5714008bf..ccd52b0b8e81847dad9a5b385f966d04074d787c 100644 (file)
--- a/expat/lib/expat.h
+++ b/expat/lib/expat.h
@@ -399,6 +399,7 @@ typedef int (*XML_NotStandaloneHandler)(void *userData);
    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.
 
    The handler should return 0 if processing should not continue
    because of a fatal error in the handling of the external entity.