[Expat-CVS] expat/doc reference.html,1.21,1.22

[Karl Waclawek]

Update of /cvsroot/expat/expat/doc
In directory usw-pr-cvs1:/tmp/cvs-serv8455

Modified Files:
	reference.html 
Log Message:
Added more detail about the unknownEncodingHandler.

Index: reference.html
===================================================================
RCS file: /cvsroot/expat/expat/doc/reference.html,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -d -r1.21 -r1.22
--- reference.html	11 Aug 2002 01:36:05 -0000	1.21
+++ reference.html	22 Aug 2002 00:06:51 -0000	1.22
@@ -1038,9 +1038,13 @@
                               XML_Encoding *info);
 </pre>
 <p>Set a handler to deal with encodings other than the
-<a href="#builtin_encodings">built in set</a>. If the handler knows how
-to deal with an encoding with the given name, it should fill in the info
-data structure and return 1. Otherwise it should return 0.</p>
+<a href="#builtin_encodings">built in set</a>. This should  be done before
+XML_Parse or XML_ParseBuffer have been called on the given parser.</p>
+<p>If the handler knows how to deal with an encoding with the given name,
+it should fill in the info data structure and return 1. Otherwise it should
+return 0. The handler will be called at most once per parsed (external) entity.
+The optional application data pointer <code>encodingHandlerData</code>
+will be passed back to the handler.</p>
 
 <pre>
     typedef struct {