[Expat-checkins] expat/doc reference.html,1.34,1.35

Karl Waclawek kwaclaw@users.sourceforge.net
Thu, 17 Oct 2002 09:45:52 -0700


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

Modified Files:
	reference.html 
Log Message:
Improved documentation of XML_ExternalEntityRefHandler.

Index: reference.html
===================================================================
RCS file: /cvsroot/expat/expat/doc/reference.html,v
retrieving revision 1.34
retrieving revision 1.35
diff -u -d -r1.34 -r1.35
--- reference.html	8 Oct 2002 14:02:02 -0000	1.34
+++ reference.html	17 Oct 2002 16:45:49 -0000	1.35
@@ -1000,6 +1000,12 @@
 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