Bunch of updates, progressive parsing, updates on HTML, XPAth and docs, Daniel
diff --git a/doc/html/gnome-xml-htmlparser.html b/doc/html/gnome-xml-htmlparser.html
index 91500b6..119e226 100644
--- a/doc/html/gnome-xml-htmlparser.html
+++ b/doc/html/gnome-xml-htmlparser.html
@@ -115,7 +115,7 @@
><DIV
CLASS="REFNAMEDIV"
><A
-NAME="AEN6377"
+NAME="AEN6506"
></A
><H2
>Name</H2
@@ -123,7 +123,7 @@
><DIV
CLASS="REFSYNOPSISDIV"
><A
-NAME="AEN6380"
+NAME="AEN6509"
></A
><H2
>Synopsis</H2
@@ -277,7 +277,7 @@
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN6418"
+NAME="AEN6547"
></A
><H2
>Description</H2
@@ -287,131 +287,248 @@
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN6421"
+NAME="AEN6550"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
-NAME="AEN6423"
+NAME="AEN6552"
></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="AEN6427"
+NAME="AEN6557"
></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="AEN6431"
+NAME="AEN6562"
></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="AEN6435"
+NAME="AEN6567"
></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="AEN6439"
+NAME="AEN6572"
></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="AEN6443"
+NAME="AEN6577"
></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="AEN6447"
+NAME="AEN6582"
></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="AEN6451"
+NAME="AEN6587"
></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="AEN6455"
+NAME="AEN6592"
></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="AEN6459"
+NAME="AEN6597"
></A
><H3
><A
@@ -467,7 +584,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> The tag name</TD
></TR
><TR
><TD
@@ -482,7 +599,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+>the related htmlElemDescPtr or NULL if not found.</TD
></TR
></TABLE
><P
@@ -492,7 +609,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN6480"
+NAME="AEN6618"
></A
><H3
><A
@@ -550,7 +667,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> the entity name</TD
></TR
><TR
><TD
@@ -565,7 +682,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+>the associated htmlEntityDescPtr if found, NULL otherwise.</TD
></TR
></TABLE
><P
@@ -575,7 +692,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN6502"
+NAME="AEN6640"
></A
><H3
><A
@@ -637,7 +754,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> an HTML parser context</TD
></TR
><TR
><TD
@@ -654,7 +771,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> location to store the entity name</TD
></TR
><TR
><TD
@@ -669,7 +786,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
@@ -679,7 +797,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN6529"
+NAME="AEN6667"
></A
><H3
><A
@@ -738,7 +856,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> an HTML parser context</TD
></TR
><TR
><TD
@@ -753,7 +871,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+>the value parsed (as an int)</TD
></TR
></TABLE
><P
@@ -763,7 +881,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN6551"
+NAME="AEN6689"
></A
><H3
><A
@@ -820,7 +938,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> an HTML parser context</TD
></TR
></TABLE
><P
@@ -830,7 +948,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN6569"
+NAME="AEN6707"
></A
><H3
><A
@@ -894,7 +1012,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> a pointer to an array of CHAR</TD
></TR
><TR
><TD
@@ -911,7 +1029,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> a free form C string describing the HTML document encoding, or NULL</TD
></TR
><TR
><TD
@@ -928,7 +1046,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> the SAX handler block</TD
></TR
><TR
><TD
@@ -945,7 +1063,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> if using SAX, this pointer will be provided on callbacks. </TD
></TR
><TR
><TD
@@ -960,7 +1078,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+>the resulting document tree</TD
></TR
></TABLE
><P
@@ -970,7 +1088,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN6603"
+NAME="AEN6741"
></A
><H3
><A
@@ -1027,7 +1145,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> a pointer to an array of CHAR</TD
></TR
><TR
><TD
@@ -1044,7 +1162,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> a free form C string describing the HTML document encoding, or NULL</TD
></TR
><TR
><TD
@@ -1059,7 +1177,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+>the resulting document tree</TD
></TR
></TABLE
><P
@@ -1069,7 +1187,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN6628"
+NAME="AEN6766"
></A
><H3
><A
@@ -1131,7 +1249,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> the filename</TD
></TR
><TR
><TD
@@ -1148,7 +1266,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> a free form C string describing the HTML document encoding, or NULL</TD
></TR
><TR
><TD
@@ -1165,7 +1283,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> the SAX handler block</TD
></TR
><TR
><TD
@@ -1182,7 +1300,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> if using SAX, this pointer will be provided on callbacks. </TD
></TR
><TR
><TD
@@ -1197,7 +1315,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+>the resulting document tree</TD
></TR
></TABLE
><P
@@ -1207,7 +1325,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN6661"
+NAME="AEN6799"
></A
><H3
><A
@@ -1262,7 +1380,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> the filename</TD
></TR
><TR
><TD
@@ -1279,7 +1397,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+> a free form C string describing the HTML document encoding, or NULL</TD
></TR
><TR
><TD
@@ -1294,7 +1412,7 @@
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
-> </TD
+>the resulting document tree</TD
></TR
></TABLE
><P