Rebuilt docs for 2.2.5, added XPointer, Daniel
diff --git a/doc/html/gnome-xml-htmlparser.html b/doc/html/gnome-xml-htmlparser.html
index ce38b23..c187341 100644
--- a/doc/html/gnome-xml-htmlparser.html
+++ b/doc/html/gnome-xml-htmlparser.html
@@ -115,7 +115,7 @@
><DIV
CLASS="REFNAMEDIV"
><A
-NAME="AEN9508"
+NAME="AEN9577"
></A
><H2
>Name</H2
@@ -123,7 +123,7 @@
><DIV
CLASS="REFSYNOPSISDIV"
><A
-NAME="AEN9511"
+NAME="AEN9580"
></A
><H2
>Synopsis</H2
@@ -376,7 +376,7 @@
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN9572"
+NAME="AEN9641"
></A
><H2
>Description</H2
@@ -386,131 +386,248 @@
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN9575"
+NAME="AEN9644"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
-NAME="AEN9577"
+NAME="AEN9646"
></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="AEN9581"
+NAME="AEN9651"
></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="AEN9585"
+NAME="AEN9656"
></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="AEN9589"
+NAME="AEN9661"
></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="AEN9593"
+NAME="AEN9666"
></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="AEN9597"
+NAME="AEN9671"
></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="AEN9601"
+NAME="AEN9676"
></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="AEN9605"
+NAME="AEN9681"
></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="AEN9609"
+NAME="AEN9686"
></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="AEN9613"
+NAME="AEN9691"
></A
><H3
><A
@@ -544,20 +661,33 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN9618"
+NAME="AEN9696"
></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="AEN9622"
+NAME="AEN9701"
></A
><H3
><A
@@ -587,20 +717,33 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN9627"
+NAME="AEN9706"
></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="AEN9631"
+NAME="AEN9711"
></A
><H3
><A
@@ -656,7 +799,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> The tag name in lowercase</TD
></TR
><TR
><TD
@@ -671,7 +814,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+>the related htmlElemDescPtr or NULL if not found.</TD
></TR
></TABLE
><P
@@ -681,7 +824,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN9652"
+NAME="AEN9732"
></A
><H3
><A
@@ -739,7 +882,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> the entity name</TD
></TR
><TR
><TD
@@ -754,7 +897,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+>the associated htmlEntityDescPtr if found, NULL otherwise.</TD
></TR
></TABLE
><P
@@ -764,7 +907,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN9674"
+NAME="AEN9754"
></A
><H3
><A
@@ -819,7 +962,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> the entity's unicode value</TD
></TR
><TR
><TD
@@ -834,7 +977,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+>the associated htmlEntityDescPtr if found, NULL otherwise.</TD
></TR
></TABLE
><P
@@ -844,7 +987,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN9695"
+NAME="AEN9775"
></A
><H3
><A
@@ -903,7 +1046,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> the HTML document</TD
></TR
><TR
><TD
@@ -920,7 +1063,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> the HTML element</TD
></TR
><TR
><TD
@@ -935,7 +1078,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+>1 if autoclosed, 0 otherwise</TD
></TR
></TABLE
><P
@@ -945,7 +1088,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN9720"
+NAME="AEN9800"
></A
><H3
><A
@@ -1009,7 +1152,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> the HTML document</TD
></TR
><TR
><TD
@@ -1026,7 +1169,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> The tag name</TD
></TR
><TR
><TD
@@ -1043,7 +1186,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> the HTML element</TD
></TR
><TR
><TD
@@ -1058,7 +1201,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+>1 if autoclose, 0 otherwise</TD
></TR
></TABLE
><P
@@ -1068,7 +1211,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN9750"
+NAME="AEN9830"
></A
><H3
><A
@@ -1130,7 +1273,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> an HTML parser context</TD
></TR
><TR
><TD
@@ -1147,7 +1290,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> location to store the entity name</TD
></TR
><TR
><TD
@@ -1162,7 +1305,8 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+>the associated htmlEntityDescPtr if found, or NULL otherwise,
+if non-NULL *str will have to be freed by the caller.</TD
></TR
></TABLE
><P
@@ -1172,7 +1316,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN9777"
+NAME="AEN9857"
></A
><H3
><A
@@ -1231,7 +1375,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> an HTML parser context</TD
></TR
><TR
><TD
@@ -1246,7 +1390,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+>the value parsed (as an int)</TD
></TR
></TABLE
><P
@@ -1256,7 +1400,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN9799"
+NAME="AEN9879"
></A
><H3
><A
@@ -1313,7 +1457,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> an HTML parser context</TD
></TR
></TABLE
><P
@@ -1323,7 +1467,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN9817"
+NAME="AEN9897"
></A
><H3
><A
@@ -1387,7 +1531,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> a pointer to an array of xmlChar</TD
></TR
><TR
><TD
@@ -1404,7 +1548,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> a free form C string describing the HTML document encoding, or NULL</TD
></TR
><TR
><TD
@@ -1421,7 +1565,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> the SAX handler block</TD
></TR
><TR
><TD
@@ -1438,7 +1582,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> if using SAX, this pointer will be provided on callbacks. </TD
></TR
><TR
><TD
@@ -1453,7 +1597,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+>the resulting document tree</TD
></TR
></TABLE
><P
@@ -1463,7 +1607,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN9851"
+NAME="AEN9931"
></A
><H3
><A
@@ -1520,7 +1664,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> a pointer to an array of xmlChar</TD
></TR
><TR
><TD
@@ -1537,7 +1681,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> a free form C string describing the HTML document encoding, or NULL</TD
></TR
><TR
><TD
@@ -1552,7 +1696,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+>the resulting document tree</TD
></TR
></TABLE
><P
@@ -1562,7 +1706,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN9876"
+NAME="AEN9956"
></A
><H3
><A
@@ -1624,7 +1768,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> the filename</TD
></TR
><TR
><TD
@@ -1641,7 +1785,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> a free form C string describing the HTML document encoding, or NULL</TD
></TR
><TR
><TD
@@ -1658,7 +1802,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> the SAX handler block</TD
></TR
><TR
><TD
@@ -1675,7 +1819,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> if using SAX, this pointer will be provided on callbacks. </TD
></TR
><TR
><TD
@@ -1690,7 +1834,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+>the resulting document tree</TD
></TR
></TABLE
><P
@@ -1700,7 +1844,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN9909"
+NAME="AEN9989"
></A
><H3
><A
@@ -1755,7 +1899,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> the filename</TD
></TR
><TR
><TD
@@ -1772,7 +1916,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> a free form C string describing the HTML document encoding, or NULL</TD
></TR
><TR
><TD
@@ -1787,7 +1931,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+>the resulting document tree</TD
></TR
></TABLE
><P
@@ -1797,7 +1941,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN9933"
+NAME="AEN10013"
></A
><H3
><A
@@ -1851,7 +1995,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> a pointer to an array of bytes to store the result</TD
></TR
><TR
><TD
@@ -1868,7 +2012,12 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> the length of <TT
+CLASS="PARAMETER"
+><I
+>out</I
+></TT
+></TD
></TR
><TR
><TD
@@ -1885,7 +2034,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> a pointer to an array of UTF-8 chars</TD
></TR
><TR
><TD
@@ -1902,7 +2051,12 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> the length of <TT
+CLASS="PARAMETER"
+><I
+>in</I
+></TT
+></TD
></TR
><TR
><TD
@@ -1917,7 +2071,20 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </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
></TABLE
><P
@@ -1927,7 +2094,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN9964"
+NAME="AEN10048"
></A
><H3
><A
@@ -1982,7 +2149,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> a pointer to an array of bytes to store the result</TD
></TR
><TR
><TD
@@ -1999,7 +2166,12 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> the length of <TT
+CLASS="PARAMETER"
+><I
+>out</I
+></TT
+></TD
></TR
><TR
><TD
@@ -2016,7 +2188,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> a pointer to an array of UTF-8 chars</TD
></TR
><TR
><TD
@@ -2033,7 +2205,12 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> the length of <TT
+CLASS="PARAMETER"
+><I
+>in</I
+></TT
+></TD
></TR
><TR
><TD
@@ -2050,7 +2227,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> the quote character to escape (' or ") or zero.</TD
></TR
><TR
><TD
@@ -2065,7 +2242,20 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </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
></TABLE
><P
@@ -2075,7 +2265,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN9999"
+NAME="AEN10087"
></A
><H3
><A
@@ -2129,7 +2319,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> an HTML parser context</TD
></TR
></TABLE
><P
@@ -2139,7 +2329,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN10015"
+NAME="AEN10103"
></A
><H3
><A
@@ -2216,7 +2406,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> a SAX handler</TD
></TR
><TR
><TD
@@ -2233,7 +2423,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> The user data returned on SAX callbacks</TD
></TR
><TR
><TD
@@ -2250,7 +2440,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> a pointer to an array of chars</TD
></TR
><TR
><TD
@@ -2267,7 +2457,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> number of chars in the array</TD
></TR
><TR
><TD
@@ -2284,7 +2474,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> an optional file name or URI</TD
></TR
><TR
><TD
@@ -2301,7 +2491,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> an optional encoding</TD
></TR
><TR
><TD
@@ -2316,7 +2506,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+>the new parser context or NULL</TD
></TR
></TABLE
><P
@@ -2326,7 +2516,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN10059"
+NAME="AEN10147"
></A
><H3
><A
@@ -2382,7 +2572,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> an XML parser context</TD
></TR
><TR
><TD
@@ -2399,7 +2589,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> an char array</TD
></TR
><TR
><TD
@@ -2416,7 +2606,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> the size in byte of the chunk</TD
></TR
><TR
><TD
@@ -2433,7 +2623,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> last chunk indicator</TD
></TR
><TR
><TD
@@ -2448,7 +2638,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+>zero if no error, the xmlParserErrors otherwise.</TD
></TR
></TABLE
><P