From 0bf90d3f52d190fa653549901891f7d6830f60f6 Mon Sep 17 00:00:00 2001 From: "Fred L. Drake, Jr." Date: Thu, 17 Oct 2002 19:13:55 +0000 Subject: [PATCH] Adjust markup a bit, adding some internal hyperlinks. --- expat/doc/reference.html | 29 ++++++++++++++++------------- 1 file changed, 16 insertions(+), 13 deletions(-) diff --git a/expat/doc/reference.html b/expat/doc/reference.html index 4142ee07..9be32f8d 100644 --- a/expat/doc/reference.html +++ b/expat/doc/reference.html @@ -1000,18 +1000,21 @@ called for processing an external DTD subset if parameter entity parsing is in effect. (See 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.