From 3d6f978672b5893aaeb474629ad4c5d609390b15 Mon Sep 17 00:00:00 2001 From: "Fred L. Drake, Jr." Date: Tue, 21 Jan 2003 05:00:51 +0000 Subject: [PATCH] Documented XML_SetExternalEntityRefHandlerArg(), including API foolishness noted in SF bug #644344. Closes SF bug #644344. --- expat/doc/reference.html | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/expat/doc/reference.html b/expat/doc/reference.html index ea8833c0..aa2a3899 100644 --- a/expat/doc/reference.html +++ b/expat/doc/reference.html @@ -74,6 +74,7 @@ Clark Cooper to retain copyright and to distribute it with Expat.

  • XML_SetDefaultHandler
  • XML_SetDefaultHandlerExpand
  • XML_SetExternalEntityRefHandler
    • +
  • XML_SetExternalEntityRefHandlerArg
  • XML_SetSkippedEntityHandler
  • XML_SetUnknownEncodingHandler
  • XML_SetStartNamespaceDeclHandler
    • @@ -1040,6 +1041,30 @@ parser, the body of the external entity can be recursively parsed.

    information into global or static variables.

    +
    +XML_SetExternalEntityRefHandlerArg(XML_Parser p,
+                                   void *arg)
+
    +
    +

    Set the argument passed to the ExternalEntityRefHandler. If +arg is not NULL, it is the new value passed to the +handler set using XML_SetExternalEntityRefHandler; if arg is +NULL, the argument passed to the handler function will be the parser +object itself.

    + +

    Note: +The type of arg and the type of the first argument to the +ExternalEntityRefHandler do not match. This function takes a +void * to be passed to the handler, while the handler +accepts an XML_Parser. This is a historical accident, +but will not be corrected before Expat 2.0 (at the earliest) to avoid +causing compiler warnings for code that's known to work with this +API. It is the responsibility of the application code to know the +actual type of the argument passed to the handler and to manage it +properly.

    +
    + 
     XML_SetSkippedEntityHandler(XML_Parser p,