rebuilt the docs for the release Daniel

* doc/html/*: rebuilt the docs for the release
Daniel
diff --git a/doc/html/libxml-htmlparser.html b/doc/html/libxml-htmlparser.html
index 8bab177..82df3f2 100644
--- a/doc/html/libxml-htmlparser.html
+++ b/doc/html/libxml-htmlparser.html
@@ -122,7 +122,7 @@
 ><DIV
 CLASS="REFNAMEDIV"
 ><A
-NAME="AEN10204"
+NAME="AEN10243"
 ></A
 ><H2
 >Name</H2
@@ -130,7 +130,7 @@
 ><DIV
 CLASS="REFSYNOPSISDIV"
 ><A
-NAME="AEN10207"
+NAME="AEN10246"
 ></A
 ><H2
 >Synopsis</H2
@@ -394,7 +394,7 @@
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN10271"
+NAME="AEN10310"
 ></A
 ><H2
 >Description</H2
@@ -404,131 +404,248 @@
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN10274"
+NAME="AEN10313"
 ></A
 ><H2
 >Details</H2
 ><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN10276"
+NAME="AEN10315"
 ></A
 ><H3
 ><A
 NAME="HTMLPARSERCTXT"
 ></A
 >htmlParserCtxt</H3
+><TABLE
+BORDER="0"
+BGCOLOR="#D6E8FF"
+WIDTH="100%"
+CELLPADDING="6"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>typedef xmlParserCtxt htmlParserCtxt;</PRE
+></TD
+></TR
+></TABLE
 ><P
 ></P
 ></DIV
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN10280"
+NAME="AEN10320"
 ></A
 ><H3
 ><A
 NAME="HTMLPARSERCTXTPTR"
 ></A
 >htmlParserCtxtPtr</H3
+><TABLE
+BORDER="0"
+BGCOLOR="#D6E8FF"
+WIDTH="100%"
+CELLPADDING="6"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>typedef xmlParserCtxtPtr htmlParserCtxtPtr;</PRE
+></TD
+></TR
+></TABLE
 ><P
 ></P
 ></DIV
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN10284"
+NAME="AEN10325"
 ></A
 ><H3
 ><A
 NAME="HTMLPARSERNODEINFO"
 ></A
 >htmlParserNodeInfo</H3
+><TABLE
+BORDER="0"
+BGCOLOR="#D6E8FF"
+WIDTH="100%"
+CELLPADDING="6"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>typedef xmlParserNodeInfo htmlParserNodeInfo;</PRE
+></TD
+></TR
+></TABLE
 ><P
 ></P
 ></DIV
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN10288"
+NAME="AEN10330"
 ></A
 ><H3
 ><A
 NAME="HTMLSAXHANDLER"
 ></A
 >htmlSAXHandler</H3
+><TABLE
+BORDER="0"
+BGCOLOR="#D6E8FF"
+WIDTH="100%"
+CELLPADDING="6"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>typedef xmlSAXHandler htmlSAXHandler;</PRE
+></TD
+></TR
+></TABLE
 ><P
 ></P
 ></DIV
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN10292"
+NAME="AEN10335"
 ></A
 ><H3
 ><A
 NAME="HTMLSAXHANDLERPTR"
 ></A
 >htmlSAXHandlerPtr</H3
+><TABLE
+BORDER="0"
+BGCOLOR="#D6E8FF"
+WIDTH="100%"
+CELLPADDING="6"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>typedef xmlSAXHandlerPtr htmlSAXHandlerPtr;</PRE
+></TD
+></TR
+></TABLE
 ><P
 ></P
 ></DIV
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN10296"
+NAME="AEN10340"
 ></A
 ><H3
 ><A
 NAME="HTMLPARSERINPUT"
 ></A
 >htmlParserInput</H3
+><TABLE
+BORDER="0"
+BGCOLOR="#D6E8FF"
+WIDTH="100%"
+CELLPADDING="6"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>typedef xmlParserInput htmlParserInput;</PRE
+></TD
+></TR
+></TABLE
 ><P
 ></P
 ></DIV
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN10300"
+NAME="AEN10345"
 ></A
 ><H3
 ><A
 NAME="HTMLPARSERINPUTPTR"
 ></A
 >htmlParserInputPtr</H3
+><TABLE
+BORDER="0"
+BGCOLOR="#D6E8FF"
+WIDTH="100%"
+CELLPADDING="6"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>typedef xmlParserInputPtr htmlParserInputPtr;</PRE
+></TD
+></TR
+></TABLE
 ><P
 ></P
 ></DIV
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN10304"
+NAME="AEN10350"
 ></A
 ><H3
 ><A
 NAME="HTMLDOCPTR"
 ></A
 >htmlDocPtr</H3
+><TABLE
+BORDER="0"
+BGCOLOR="#D6E8FF"
+WIDTH="100%"
+CELLPADDING="6"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>typedef xmlDocPtr htmlDocPtr;</PRE
+></TD
+></TR
+></TABLE
 ><P
 ></P
 ></DIV
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN10308"
+NAME="AEN10355"
 ></A
 ><H3
 ><A
 NAME="HTMLNODEPTR"
 ></A
 >htmlNodePtr</H3
+><TABLE
+BORDER="0"
+BGCOLOR="#D6E8FF"
+WIDTH="100%"
+CELLPADDING="6"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>typedef xmlNodePtr htmlNodePtr;</PRE
+></TD
+></TR
+></TABLE
 ><P
 ></P
 ></DIV
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN10312"
+NAME="AEN10360"
 ></A
 ><H3
 ><A
@@ -564,20 +681,33 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN10317"
+NAME="AEN10365"
 ></A
 ><H3
 ><A
 NAME="HTMLELEMDESCPTR"
 ></A
 >htmlElemDescPtr</H3
+><TABLE
+BORDER="0"
+BGCOLOR="#D6E8FF"
+WIDTH="100%"
+CELLPADDING="6"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>typedef htmlElemDesc *htmlElemDescPtr;</PRE
+></TD
+></TR
+></TABLE
 ><P
 ></P
 ></DIV
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN10321"
+NAME="AEN10370"
 ></A
 ><H3
 ><A
@@ -607,20 +737,33 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN10326"
+NAME="AEN10375"
 ></A
 ><H3
 ><A
 NAME="HTMLENTITYDESCPTR"
 ></A
 >htmlEntityDescPtr</H3
+><TABLE
+BORDER="0"
+BGCOLOR="#D6E8FF"
+WIDTH="100%"
+CELLPADDING="6"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>typedef htmlEntityDesc *htmlEntityDescPtr;</PRE
+></TD
+></TR
+></TABLE
 ><P
 ></P
 ></DIV
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN10330"
+NAME="AEN10380"
 ></A
 ><H3
 ><A
@@ -653,7 +796,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN10338"
+NAME="AEN10388"
 ></A
 ><P
 ></P
@@ -680,7 +823,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  The tag name in lowercase</TD
 ></TR
 ><TR
 ><TD
@@ -695,7 +838,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>the related htmlElemDescPtr or NULL if not found.</TD
 ></TR
 ></TBODY
 ></TABLE
@@ -706,7 +849,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN10351"
+NAME="AEN10401"
 ></A
 ><H3
 ><A
@@ -741,7 +884,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN10360"
+NAME="AEN10410"
 ></A
 ><P
 ></P
@@ -768,7 +911,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+> the entity name</TD
 ></TR
 ><TR
 ><TD
@@ -783,7 +926,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>the associated htmlEntityDescPtr if found, NULL otherwise.</TD
 ></TR
 ></TBODY
 ></TABLE
@@ -794,7 +937,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN10373"
+NAME="AEN10423"
 ></A
 ><H3
 ><A
@@ -826,7 +969,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN10381"
+NAME="AEN10431"
 ></A
 ><P
 ></P
@@ -853,7 +996,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+> the entity's unicode value</TD
 ></TR
 ><TR
 ><TD
@@ -868,7 +1011,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>the associated htmlEntityDescPtr if found, NULL otherwise.</TD
 ></TR
 ></TBODY
 ></TABLE
@@ -879,7 +1022,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN10394"
+NAME="AEN10444"
 ></A
 ><H3
 ><A
@@ -915,7 +1058,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN10402"
+NAME="AEN10452"
 ></A
 ><P
 ></P
@@ -942,7 +1085,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  the HTML document</TD
 ></TR
 ><TR
 ><TD
@@ -959,7 +1102,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  the HTML element</TD
 ></TR
 ><TR
 ><TD
@@ -974,7 +1117,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>1 if autoclosed, 0 otherwise</TD
 ></TR
 ></TBODY
 ></TABLE
@@ -985,7 +1128,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN10419"
+NAME="AEN10469"
 ></A
 ><H3
 ><A
@@ -1026,7 +1169,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN10428"
+NAME="AEN10478"
 ></A
 ><P
 ></P
@@ -1053,7 +1196,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  the HTML document</TD
 ></TR
 ><TR
 ><TD
@@ -1070,7 +1213,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  The tag name</TD
 ></TR
 ><TR
 ><TD
@@ -1087,7 +1230,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  the HTML element</TD
 ></TR
 ><TR
 ><TD
@@ -1102,7 +1245,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>1 if autoclose, 0 otherwise</TD
 ></TR
 ></TBODY
 ></TABLE
@@ -1113,7 +1256,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN10449"
+NAME="AEN10499"
 ></A
 ><H3
 ><A
@@ -1152,7 +1295,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN10459"
+NAME="AEN10509"
 ></A
 ><P
 ></P
@@ -1179,7 +1322,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  an HTML parser context</TD
 ></TR
 ><TR
 ><TD
@@ -1196,7 +1339,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  location to store the entity name</TD
 ></TR
 ><TR
 ><TD
@@ -1211,7 +1354,8 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>the associated htmlEntityDescPtr if found, or NULL otherwise,
+if non-NULL *str will have to be freed by the caller.</TD
 ></TR
 ></TBODY
 ></TABLE
@@ -1222,7 +1366,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN10476"
+NAME="AEN10526"
 ></A
 ><H3
 ><A
@@ -1258,7 +1402,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN10485"
+NAME="AEN10535"
 ></A
 ><P
 ></P
@@ -1285,7 +1429,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  an HTML parser context</TD
 ></TR
 ><TR
 ><TD
@@ -1300,7 +1444,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>the value parsed (as an int)</TD
 ></TR
 ></TBODY
 ></TABLE
@@ -1311,7 +1455,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN10498"
+NAME="AEN10548"
 ></A
 ><H3
 ><A
@@ -1345,7 +1489,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN10507"
+NAME="AEN10557"
 ></A
 ><P
 ></P
@@ -1372,7 +1516,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  an HTML parser context</TD
 ></TR
 ></TBODY
 ></TABLE
@@ -1383,7 +1527,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN10516"
+NAME="AEN10566"
 ></A
 ><H3
 ><A
@@ -1416,15 +1560,15 @@
 ></TR
 ></TABLE
 ><P
->parse an HTML in-memory document and build a tree.
-It use the given SAX function block to handle the parsing callback.
-If sax is NULL, fallback to the default DOM tree building routines.</P
+>Parse an HTML in-memory document. If sax is not NULL, use the SAX callbacks
+to handle parse events. If sax is NULL, fallback to the default DOM
+behavior and return a tree.</P
 ><P
 ></P
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN10525"
+NAME="AEN10575"
 ></A
 ><P
 ></P
@@ -1451,7 +1595,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  a pointer to an array of xmlChar</TD
 ></TR
 ><TR
 ><TD
@@ -1468,7 +1612,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  a free form C string describing the HTML document encoding, or NULL</TD
 ></TR
 ><TR
 ><TD
@@ -1485,7 +1629,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  the SAX handler block</TD
 ></TR
 ><TR
 ><TD
@@ -1502,7 +1646,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+> if using SAX, this pointer will be provided on callbacks. </TD
 ></TR
 ><TR
 ><TD
@@ -1517,7 +1661,8 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>the resulting document tree unless SAX is NULL or the document is
+not well formed.</TD
 ></TR
 ></TBODY
 ></TABLE
@@ -1528,7 +1673,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN10550"
+NAME="AEN10600"
 ></A
 ><H3
 ><A
@@ -1562,7 +1707,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN10558"
+NAME="AEN10608"
 ></A
 ><P
 ></P
@@ -1589,7 +1734,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  a pointer to an array of xmlChar</TD
 ></TR
 ><TR
 ><TD
@@ -1606,7 +1751,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  a free form C string describing the HTML document encoding, or NULL</TD
 ></TR
 ><TR
 ><TD
@@ -1621,7 +1766,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>the resulting document tree</TD
 ></TR
 ></TBODY
 ></TABLE
@@ -1632,7 +1777,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN10575"
+NAME="AEN10625"
 ></A
 ><H3
 ><A
@@ -1671,7 +1816,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN10583"
+NAME="AEN10633"
 ></A
 ><P
 ></P
@@ -1698,7 +1843,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  the filename</TD
 ></TR
 ><TR
 ><TD
@@ -1715,7 +1860,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  a free form C string describing the HTML document encoding, or NULL</TD
 ></TR
 ><TR
 ><TD
@@ -1732,7 +1877,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  the SAX handler block</TD
 ></TR
 ><TR
 ><TD
@@ -1749,7 +1894,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+> if using SAX, this pointer will be provided on callbacks. </TD
 ></TR
 ><TR
 ><TD
@@ -1764,7 +1909,8 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>the resulting document tree unless SAX is NULL or the document is
+not well formed.</TD
 ></TR
 ></TBODY
 ></TABLE
@@ -1775,7 +1921,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN10608"
+NAME="AEN10658"
 ></A
 ><H3
 ><A
@@ -1807,7 +1953,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN10615"
+NAME="AEN10665"
 ></A
 ><P
 ></P
@@ -1834,7 +1980,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  the filename</TD
 ></TR
 ><TR
 ><TD
@@ -1851,7 +1997,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  a free form C string describing the HTML document encoding, or NULL</TD
 ></TR
 ><TR
 ><TD
@@ -1866,7 +2012,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>the resulting document tree</TD
 ></TR
 ></TBODY
 ></TABLE
@@ -1877,7 +2023,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN10632"
+NAME="AEN10682"
 ></A
 ><H3
 ><A
@@ -1908,7 +2054,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN10638"
+NAME="AEN10688"
 ></A
 ><P
 ></P
@@ -1935,7 +2081,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  a pointer to an array of bytes to store the result</TD
 ></TR
 ><TR
 ><TD
@@ -1952,7 +2098,12 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  the length of <TT
+CLASS="PARAMETER"
+><I
+>out</I
+></TT
+></TD
 ></TR
 ><TR
 ><TD
@@ -1969,7 +2120,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  a pointer to an array of UTF-8 chars</TD
 ></TR
 ><TR
 ><TD
@@ -1986,7 +2137,12 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  the length of <TT
+CLASS="PARAMETER"
+><I
+>in</I
+></TT
+></TD
 ></TR
 ><TR
 ><TD
@@ -2001,7 +2157,20 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>0 if success, -2 if the transcoding fails, or -1 otherwise
+The value of <TT
+CLASS="PARAMETER"
+><I
+>inlen</I
+></TT
+> after return is the number of octets consumed
+as the return value is positive, else unpredictiable.
+The value of <TT
+CLASS="PARAMETER"
+><I
+>outlen</I
+></TT
+> after return is the number of octets consumed.</TD
 ></TR
 ></TBODY
 ></TABLE
@@ -2012,7 +2181,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN10663"
+NAME="AEN10717"
 ></A
 ><H3
 ><A
@@ -2044,7 +2213,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN10669"
+NAME="AEN10723"
 ></A
 ><P
 ></P
@@ -2071,7 +2240,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  a pointer to an array of bytes to store the result</TD
 ></TR
 ><TR
 ><TD
@@ -2088,7 +2257,12 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  the length of <TT
+CLASS="PARAMETER"
+><I
+>out</I
+></TT
+></TD
 ></TR
 ><TR
 ><TD
@@ -2105,7 +2279,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  a pointer to an array of UTF-8 chars</TD
 ></TR
 ><TR
 ><TD
@@ -2122,7 +2296,12 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  the length of <TT
+CLASS="PARAMETER"
+><I
+>in</I
+></TT
+></TD
 ></TR
 ><TR
 ><TD
@@ -2139,7 +2318,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+> the quote character to escape (' or ") or zero.</TD
 ></TR
 ><TR
 ><TD
@@ -2154,7 +2333,20 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>0 if success, -2 if the transcoding fails, or -1 otherwise
+The value of <TT
+CLASS="PARAMETER"
+><I
+>inlen</I
+></TT
+> after return is the number of octets consumed
+as the return value is positive, else unpredictiable.
+The value of <TT
+CLASS="PARAMETER"
+><I
+>outlen</I
+></TT
+> after return is the number of octets consumed.</TD
 ></TR
 ></TBODY
 ></TABLE
@@ -2165,7 +2357,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN10698"
+NAME="AEN10756"
 ></A
 ><H3
 ><A
@@ -2195,7 +2387,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN10705"
+NAME="AEN10763"
 ></A
 ><P
 ></P
@@ -2222,7 +2414,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  an attribute name</TD
 ></TR
 ><TR
 ><TD
@@ -2237,7 +2429,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>1 is the attribute is a script 0 otherwise</TD
 ></TR
 ></TBODY
 ></TABLE
@@ -2248,7 +2440,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN10718"
+NAME="AEN10776"
 ></A
 ><H3
 ><A
@@ -2275,7 +2467,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN10724"
+NAME="AEN10782"
 ></A
 ><P
 ></P
@@ -2302,7 +2494,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  int 0 or 1 </TD
 ></TR
 ><TR
 ><TD
@@ -2317,7 +2509,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>the last value for 0 for no handling, 1 for auto insertion.</TD
 ></TR
 ></TBODY
 ></TABLE
@@ -2328,7 +2520,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN10737"
+NAME="AEN10795"
 ></A
 ><H3
 ><A
@@ -2359,7 +2551,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN10744"
+NAME="AEN10802"
 ></A
 ><P
 ></P
@@ -2386,7 +2578,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  an HTML parser context</TD
 ></TR
 ></TBODY
 ></TABLE
@@ -2397,7 +2589,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN10753"
+NAME="AEN10811"
 ></A
 ><H3
 ><A
@@ -2451,7 +2643,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN10764"
+NAME="AEN10822"
 ></A
 ><P
 ></P
@@ -2478,7 +2670,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  a SAX handler</TD
 ></TR
 ><TR
 ><TD
@@ -2495,7 +2687,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  The user data returned on SAX callbacks</TD
 ></TR
 ><TR
 ><TD
@@ -2512,7 +2704,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  a pointer to an array of chars</TD
 ></TR
 ><TR
 ><TD
@@ -2529,7 +2721,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  number of chars in the array</TD
 ></TR
 ><TR
 ><TD
@@ -2546,7 +2738,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  an optional file name or URI</TD
 ></TR
 ><TR
 ><TD
@@ -2563,7 +2755,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  an optional encoding</TD
 ></TR
 ><TR
 ><TD
@@ -2578,7 +2770,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>the new parser context or NULL</TD
 ></TR
 ></TBODY
 ></TABLE
@@ -2589,7 +2781,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN10797"
+NAME="AEN10855"
 ></A
 ><H3
 ><A
@@ -2622,7 +2814,7 @@
 ><DIV
 CLASS="INFORMALTABLE"
 ><A
-NAME="AEN10804"
+NAME="AEN10862"
 ></A
 ><P
 ></P
@@ -2649,7 +2841,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  an XML parser context</TD
 ></TR
 ><TR
 ><TD
@@ -2666,7 +2858,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  an char array</TD
 ></TR
 ><TR
 ><TD
@@ -2683,7 +2875,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  the size in byte of the chunk</TD
 ></TR
 ><TR
 ><TD
@@ -2700,7 +2892,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  last chunk indicator</TD
 ></TR
 ><TR
 ><TD
@@ -2715,7 +2907,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>zero if no error, the xmlParserErrors otherwise.</TD
 ></TR
 ></TBODY
 ></TABLE