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_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,