XML_SetParamEntityParsing.)
-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.
+The context parameter specifies the parsing context in
+the format expected by the context argument to XML_ExternalEntityParserCreate. code 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.
The base parameter is the base to use for relative system identifiers. -It is set by XML_SetBase and may be null. The -public id parameter is the public id given in the entity declaration and -may be null. The system id is the system identifier specified in the entity -declaration and is never null.
+The base parameter is the base to use for relative
+system identifiers. It is set by XML_SetBase and may be NULL. The
+publicId parameter is the public id given in the entity
+declaration and may be NULL. systemId is the system
+identifier specified in the entity declaration and is never NULL.
There are a couple of ways in which this handler differs from others.
First, this handler returns an integer. A non-zero value should be returned
@@ -1021,8 +1024,8 @@ an XML_ERROR_EXTERNAL_ENTITY_HANDLING error.
Second, instead of having userData as its first argument, it receives the
parser that encountered the entity reference. This, along with the context
-parameter, may be used as arguments to a call to
-XML_ExternalEntityParserCreate.
+parameter, may be used as arguments to a call to XML_ExternalEntityParserCreate.
Using the returned parser, the body of the external entity can be recursively
parsed.