From af06759eedd9f023d7dba16306ce3c60faeb4b00 Mon Sep 17 00:00:00 2001 From: fdrake Date: Thu, 17 Oct 2002 19:13:55 +0000 Subject: Adjust markup a bit, adding some internal hyperlinks. --- doc/reference.html | 31 +++++++++++++++++-------------- 1 file changed, 17 insertions(+), 14 deletions(-) (limited to 'doc') diff --git a/doc/reference.html b/doc/reference.html index 4142ee0..9be32f8 100644 --- a/doc/reference.html +++ b/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 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 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 +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.

-- cgit v1.2.1