diff --git a/ChangeLog b/ChangeLog
index 70c31f96..1012814e 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+Sat Jul  6 21:11:20 CEST 2002 Daniel Veillard <daniel@veillard.com>
+
+	* parser.c: fixing bug #84169 by fixing the
+	  comment of xmlCreatePushParserCtxt to describe the 
+	  encoding detection parameters better.
+
 Sat Jul  6 19:44:56 CEST 2002 Daniel Veillard <daniel@veillard.com>
 
 	* valid.c: fixing bug #79331 in one path the lookup for
diff --git a/parser.c b/parser.c
index 2338100d..38658f9b 100644
--- a/parser.c
+++ b/parser.c
@@ -8939,13 +8939,17 @@ xmlStopParser(xmlParserCtxtPtr ctxt) {
  * @size:  number of chars in the array
  * @filename:  an optional file name or URI
  *
- * Create a parser context for using the XML parser in push mode
+ * Create a parser context for using the XML parser in push mode.
+ * If @buffer and @size are non-NULL, the data is used to detect
+ * the encoding.  The remaining characters will be parsed so they
+ * don't need to be fed in again through xmlParseChunk.
  * To allow content encoding detection, @size should be >= 4
  * The value of @filename is used for fetching external entities
  * and error/warning reports.
  *
  * Returns the new parser context or NULL
  */
+
 xmlParserCtxtPtr
 xmlCreatePushParserCtxt(xmlSAXHandlerPtr sax, void *user_data, 
                         const char *chunk, int size, const char *filename) {