diff --git a/doc/html/gnome-xml-encoding.html b/doc/html/gnome-xml-encoding.html
index 4965c1c..cd9201e 100644
--- a/doc/html/gnome-xml-encoding.html
+++ b/doc/html/gnome-xml-encoding.html
@@ -115,7 +115,7 @@
 ><DIV
 CLASS="REFNAMEDIV"
 ><A
-NAME="AEN15431"
+NAME="AEN15897"
 ></A
 ><H2
 >Name</H2
@@ -123,7 +123,7 @@
 ><DIV
 CLASS="REFSYNOPSISDIV"
 ><A
-NAME="AEN15434"
+NAME="AEN15900"
 ></A
 ><H2
 >Synopsis</H2
@@ -300,7 +300,7 @@
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN15476"
+NAME="AEN15942"
 ></A
 ><H2
 >Description</H2
@@ -310,14 +310,14 @@
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN15479"
+NAME="AEN15945"
 ></A
 ><H2
 >Details</H2
 ><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15481"
+NAME="AEN15947"
 ></A
 ><H3
 ><A
@@ -368,7 +368,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15486"
+NAME="AEN15952"
 ></A
 ><H3
 ><A
@@ -495,7 +495,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15516"
+NAME="AEN15982"
 ></A
 ><H3
 ><A
@@ -622,7 +622,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15546"
+NAME="AEN16012"
 ></A
 ><H3
 ><A
@@ -656,20 +656,33 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15551"
+NAME="AEN16017"
 ></A
 ><H3
 ><A
 NAME="XMLCHARENCODINGHANDLERPTR"
 ></A
 >xmlCharEncodingHandlerPtr</H3
+><TABLE
+BORDER="0"
+BGCOLOR="#D6E8FF"
+WIDTH="100%"
+CELLPADDING="6"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>typedef xmlCharEncodingHandler *xmlCharEncodingHandlerPtr;</PRE
+></TD
+></TR
+></TABLE
 ><P
 ></P
 ></DIV
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15555"
+NAME="AEN16022"
 ></A
 ><H3
 ><A
@@ -700,7 +713,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15561"
+NAME="AEN16028"
 ></A
 ><H3
 ><A
@@ -729,7 +742,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15567"
+NAME="AEN16034"
 ></A
 ><H3
 ><A
@@ -782,7 +795,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  the xmlCharEncodingHandlerPtr handler block</TD
 ></TR
 ></TABLE
 ><P
@@ -792,7 +805,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15583"
+NAME="AEN16050"
 ></A
 ><H3
 ><A
@@ -849,7 +862,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  a string describing the char encoding.</TD
 ></TR
 ><TR
 ><TD
@@ -864,7 +877,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>the handler or NULL if not found</TD
 ></TR
 ></TABLE
 ><P
@@ -874,7 +887,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15604"
+NAME="AEN16071"
 ></A
 ><H3
 ><A
@@ -951,7 +964,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15623"
+NAME="AEN16090"
 ></A
 ><H3
 ><A
@@ -1013,7 +1026,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  the encoding name as parsed, in UTF-8 format (ASCII actually)</TD
 ></TR
 ><TR
 ><TD
@@ -1030,7 +1043,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  the alias name as parsed, in UTF-8 format (ASCII actually)</TD
 ></TR
 ><TR
 ><TD
@@ -1045,7 +1058,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>0 in case of success, -1 in case of error</TD
 ></TR
 ></TABLE
 ><P
@@ -1055,7 +1068,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15648"
+NAME="AEN16115"
 ></A
 ><H3
 ><A
@@ -1110,7 +1123,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  the alias name as parsed, in UTF-8 format (ASCII actually)</TD
 ></TR
 ><TR
 ><TD
@@ -1125,7 +1138,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>0 in case of success, -1 in case of error</TD
 ></TR
 ></TABLE
 ><P
@@ -1135,7 +1148,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15668"
+NAME="AEN16135"
 ></A
 ><H3
 ><A
@@ -1185,7 +1198,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  the alias name as parsed, in UTF-8 format (ASCII actually)</TD
 ></TR
 ><TR
 ><TD
@@ -1200,7 +1213,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>NULL if not found the original name otherwise</TD
 ></TR
 ></TABLE
 ><P
@@ -1210,7 +1223,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15687"
+NAME="AEN16154"
 ></A
 ><H3
 ><A
@@ -1238,7 +1251,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15693"
+NAME="AEN16160"
 ></A
 ><H3
 ><A
@@ -1293,7 +1306,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  the encoding name as parsed, in UTF-8 format (ASCII actually)</TD
 ></TR
 ><TR
 ><TD
@@ -1308,7 +1321,8 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>one of the XML_CHAR_ENCODING_... values or XML_CHAR_ENCODING_NONE
+if not recognized.</TD
 ></TR
 ></TABLE
 ><P
@@ -1318,7 +1332,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15713"
+NAME="AEN16180"
 ></A
 ><H3
 ><A
@@ -1376,7 +1390,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  the encoding</TD
 ></TR
 ><TR
 ><TD
@@ -1391,7 +1405,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>the canonical name for the given encoding</TD
 ></TR
 ></TABLE
 ><P
@@ -1401,7 +1415,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15734"
+NAME="AEN16201"
 ></A
 ><H3
 ><A
@@ -1456,7 +1470,8 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  a pointer to the first bytes of the XML entity, must be at least
+4 bytes long.</TD
 ></TR
 ><TR
 ><TD
@@ -1473,7 +1488,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  pointer to the length of the buffer</TD
 ></TR
 ><TR
 ><TD
@@ -1488,7 +1503,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>one of the XML_CHAR_ENCODING_... values.</TD
 ></TR
 ></TABLE
 ><P
@@ -1498,7 +1513,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15758"
+NAME="AEN16225"
 ></A
 ><H3
 ><A
@@ -1563,7 +1578,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+> Pointer to putative utf-8 encoded string.</TD
 ></TR
 ><TR
 ><TD
@@ -1578,7 +1593,12 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+> true if <TT
+CLASS="PARAMETER"
+><I
+>utf</I
+></TT
+> is valid.</TD
 ></TR
 ></TABLE
 ><P
@@ -1588,7 +1608,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15779"
+NAME="AEN16247"
 ></A
 ><H3
 ><A
@@ -1659,7 +1679,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>	char enconding transformation data structure</TD
 ></TR
 ><TR
 ><TD
@@ -1676,7 +1696,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  an xmlBuffer for the output.</TD
 ></TR
 ><TR
 ><TD
@@ -1693,7 +1713,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  an xmlBuffer for the input</TD
 ></TR
 ><TR
 ><TD
@@ -1708,7 +1728,10 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>the number of byte written if success, or 
+-1 general error
+-2 if the transcoding fails (for *in is not valid utf8 string or
+the result of transformation can't fit into the encoding we want), or</TD
 ></TR
 ></TABLE
 ><P
@@ -1718,7 +1741,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15810"
+NAME="AEN16278"
 ></A
 ><H3
 ><A
@@ -1779,7 +1802,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>	char enconding transformation data structure</TD
 ></TR
 ><TR
 ><TD
@@ -1796,7 +1819,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  an xmlBuffer for the output.</TD
 ></TR
 ><TR
 ><TD
@@ -1813,7 +1836,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  an xmlBuffer for the input</TD
 ></TR
 ><TR
 ><TD
@@ -1828,7 +1851,10 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>the number of byte written if success, or 
+-1 general error
+-2 if the transcoding fails (for *in is not valid utf8 string or
+the result of transformation can't fit into the encoding we want), or</TD
 ></TR
 ></TABLE
 ><P
@@ -1838,7 +1864,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15840"
+NAME="AEN16308"
 ></A
 ><H3
 ><A
@@ -1900,7 +1926,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>	char enconding transformation data structure</TD
 ></TR
 ><TR
 ><TD
@@ -1917,7 +1943,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  an xmlBuffer for the output.</TD
 ></TR
 ><TR
 ><TD
@@ -1934,7 +1960,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>  an xmlBuffer for the input</TD
 ></TR
 ><TR
 ><TD
@@ -1949,7 +1975,10 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>the number of byte written if success, or 
+-1 general error
+-2 if the transcoding fails (for *in is not valid utf8 string or
+the result of transformation can't fit into the encoding we want), or</TD
 ></TR
 ></TABLE
 ><P
@@ -1959,7 +1988,7 @@
 ><HR><DIV
 CLASS="REFSECT2"
 ><A
-NAME="AEN15870"
+NAME="AEN16338"
 ></A
 ><H3
 ><A
@@ -2012,7 +2041,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>	char enconding transformation data structure</TD
 ></TR
 ><TR
 ><TD
@@ -2027,7 +2056,7 @@
 WIDTH="80%"
 ALIGN="LEFT"
 VALIGN="TOP"
->&nbsp;</TD
+>0 if success, or -1 in case of error</TD
 ></TR
 ></TABLE
 ><P