Added call to create/free parser contexts, + doc, Daniel.
diff --git a/doc/html/gnome-xml-parserinternals.html b/doc/html/gnome-xml-parserinternals.html
index 2820888..df0e2fa 100644
--- a/doc/html/gnome-xml-parserinternals.html
+++ b/doc/html/gnome-xml-parserinternals.html
@@ -59,7 +59,7 @@
><DIV
CLASS="REFNAMEDIV"
><A
-NAME="AEN3919"
+NAME="AEN3936"
></A
><H2
>Name</H2
@@ -67,7 +67,7 @@
><DIV
CLASS="REFSYNOPSISDIV"
><A
-NAME="AEN3922"
+NAME="AEN3939"
></A
><H2
>Synopsis</H2
@@ -82,6 +82,38 @@
CLASS="SYNOPSIS"
>
+<A
+HREF="gnome-xml-parser.html#XMLPARSERCTXTPTR"
+>xmlParserCtxtPtr</A
+> <A
+HREF="gnome-xml-parserinternals.html#XMLCREATEDOCPARSERCTXT"
+>xmlCreateDocParserCtxt</A
+> (<A
+HREF="gnome-xml-tree.html#CHAR"
+>CHAR</A
+> *cur);
+<A
+HREF="gnome-xml-parser.html#XMLPARSERCTXTPTR"
+>xmlParserCtxtPtr</A
+> <A
+HREF="gnome-xml-parserinternals.html#XMLCREATEFILEPARSERCTXT"
+>xmlCreateFileParserCtxt</A
+> (const char *filename);
+<A
+HREF="gnome-xml-parser.html#XMLPARSERCTXTPTR"
+>xmlParserCtxtPtr</A
+> <A
+HREF="gnome-xml-parserinternals.html#XMLCREATEMEMORYPARSERCTXT"
+>xmlCreateMemoryParserCtxt</A
+> (char *buffer,
+ int size);
+void <A
+HREF="gnome-xml-parserinternals.html#XMLFREEPARSERCTXT"
+>xmlFreeParserCtxt</A
+> (<A
+HREF="gnome-xml-parser.html#XMLPARSERCTXTPTR"
+>xmlParserCtxtPtr</A
+> ctxt);
void <A
HREF="gnome-xml-parserinternals.html#XMLHANDLEENTITY"
>xmlHandleEntity</A
@@ -558,7 +590,7 @@
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN4060"
+NAME="AEN4086"
></A
><H2
>Description</H2
@@ -568,14 +600,333 @@
><DIV
CLASS="REFSECT1"
><A
-NAME="AEN4063"
+NAME="AEN4089"
></A
><H2
>Details</H2
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4065"
+NAME="AEN4091"
+></A
+><H3
+><A
+NAME="XMLCREATEDOCPARSERCTXT"
+></A
+>xmlCreateDocParserCtxt()</H3
+><TABLE
+BORDER="0"
+BGCOLOR="#E8E8F8"
+WIDTH="100%"
+CELLPADDING="6"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+><A
+HREF="gnome-xml-parser.html#XMLPARSERCTXTPTR"
+>xmlParserCtxtPtr</A
+> xmlCreateDocParserCtxt (<A
+HREF="gnome-xml-tree.html#CHAR"
+>CHAR</A
+> *cur);</PRE
+></TD
+></TR
+></TABLE
+><P
+></P
+><DIV
+CLASS="INFORMALTABLE"
+><P
+></P
+><TABLE
+BORDER="0"
+WIDTH="100%"
+BGCOLOR="#FFE0E0"
+CELLSPACING="0"
+CELLPADDING="4"
+CLASS="CALSTABLE"
+><TR
+><TD
+WIDTH="20%"
+ALIGN="RIGHT"
+VALIGN="TOP"
+><TT
+CLASS="PARAMETER"
+><I
+>cur</I
+></TT
+> :</TD
+><TD
+WIDTH="80%"
+ALIGN="LEFT"
+VALIGN="TOP"
+> </TD
+></TR
+><TR
+><TD
+WIDTH="20%"
+ALIGN="RIGHT"
+VALIGN="TOP"
+><I
+CLASS="EMPHASIS"
+>Returns</I
+> :</TD
+><TD
+WIDTH="80%"
+ALIGN="LEFT"
+VALIGN="TOP"
+> </TD
+></TR
+></TABLE
+><P
+></P
+></DIV
+></DIV
+><HR><DIV
+CLASS="REFSECT2"
+><A
+NAME="AEN4111"
+></A
+><H3
+><A
+NAME="XMLCREATEFILEPARSERCTXT"
+></A
+>xmlCreateFileParserCtxt()</H3
+><TABLE
+BORDER="0"
+BGCOLOR="#E8E8F8"
+WIDTH="100%"
+CELLPADDING="6"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+><A
+HREF="gnome-xml-parser.html#XMLPARSERCTXTPTR"
+>xmlParserCtxtPtr</A
+> xmlCreateFileParserCtxt (const char *filename);</PRE
+></TD
+></TR
+></TABLE
+><P
+>Create a parser context for a file content.
+Automatic support for ZLIB/Compress compressed document is provided
+by default if found at compile-time.</P
+><P
+></P
+><DIV
+CLASS="INFORMALTABLE"
+><P
+></P
+><TABLE
+BORDER="0"
+WIDTH="100%"
+BGCOLOR="#FFE0E0"
+CELLSPACING="0"
+CELLPADDING="4"
+CLASS="CALSTABLE"
+><TR
+><TD
+WIDTH="20%"
+ALIGN="RIGHT"
+VALIGN="TOP"
+><TT
+CLASS="PARAMETER"
+><I
+>filename</I
+></TT
+> :</TD
+><TD
+WIDTH="80%"
+ALIGN="LEFT"
+VALIGN="TOP"
+> the filename</TD
+></TR
+><TR
+><TD
+WIDTH="20%"
+ALIGN="RIGHT"
+VALIGN="TOP"
+><I
+CLASS="EMPHASIS"
+>Returns</I
+> :</TD
+><TD
+WIDTH="80%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>the new parser context or NULL</TD
+></TR
+></TABLE
+><P
+></P
+></DIV
+></DIV
+><HR><DIV
+CLASS="REFSECT2"
+><A
+NAME="AEN4131"
+></A
+><H3
+><A
+NAME="XMLCREATEMEMORYPARSERCTXT"
+></A
+>xmlCreateMemoryParserCtxt()</H3
+><TABLE
+BORDER="0"
+BGCOLOR="#E8E8F8"
+WIDTH="100%"
+CELLPADDING="6"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+><A
+HREF="gnome-xml-parser.html#XMLPARSERCTXTPTR"
+>xmlParserCtxtPtr</A
+> xmlCreateMemoryParserCtxt (char *buffer,
+ int size);</PRE
+></TD
+></TR
+></TABLE
+><P
+>Create a parser context for an XML in-memory document.</P
+><P
+></P
+><DIV
+CLASS="INFORMALTABLE"
+><P
+></P
+><TABLE
+BORDER="0"
+WIDTH="100%"
+BGCOLOR="#FFE0E0"
+CELLSPACING="0"
+CELLPADDING="4"
+CLASS="CALSTABLE"
+><TR
+><TD
+WIDTH="20%"
+ALIGN="RIGHT"
+VALIGN="TOP"
+><TT
+CLASS="PARAMETER"
+><I
+>buffer</I
+></TT
+> :</TD
+><TD
+WIDTH="80%"
+ALIGN="LEFT"
+VALIGN="TOP"
+> an pointer to a char array</TD
+></TR
+><TR
+><TD
+WIDTH="20%"
+ALIGN="RIGHT"
+VALIGN="TOP"
+><TT
+CLASS="PARAMETER"
+><I
+>size</I
+></TT
+> :</TD
+><TD
+WIDTH="80%"
+ALIGN="LEFT"
+VALIGN="TOP"
+> the siwe of the array</TD
+></TR
+><TR
+><TD
+WIDTH="20%"
+ALIGN="RIGHT"
+VALIGN="TOP"
+><I
+CLASS="EMPHASIS"
+>Returns</I
+> :</TD
+><TD
+WIDTH="80%"
+ALIGN="LEFT"
+VALIGN="TOP"
+>the new parser context or NULL</TD
+></TR
+></TABLE
+><P
+></P
+></DIV
+></DIV
+><HR><DIV
+CLASS="REFSECT2"
+><A
+NAME="AEN4155"
+></A
+><H3
+><A
+NAME="XMLFREEPARSERCTXT"
+></A
+>xmlFreeParserCtxt()</H3
+><TABLE
+BORDER="0"
+BGCOLOR="#E8E8F8"
+WIDTH="100%"
+CELLPADDING="6"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+>void xmlFreeParserCtxt (<A
+HREF="gnome-xml-parser.html#XMLPARSERCTXTPTR"
+>xmlParserCtxtPtr</A
+> ctxt);</PRE
+></TD
+></TR
+></TABLE
+><P
+>Free all the memory used by a parser context. However the parsed
+document in ctxt->doc is not freed.</P
+><P
+></P
+><DIV
+CLASS="INFORMALTABLE"
+><P
+></P
+><TABLE
+BORDER="0"
+WIDTH="100%"
+BGCOLOR="#FFE0E0"
+CELLSPACING="0"
+CELLPADDING="4"
+CLASS="CALSTABLE"
+><TR
+><TD
+WIDTH="20%"
+ALIGN="RIGHT"
+VALIGN="TOP"
+><TT
+CLASS="PARAMETER"
+><I
+>ctxt</I
+></TT
+> :</TD
+><TD
+WIDTH="80%"
+ALIGN="LEFT"
+VALIGN="TOP"
+> an XML parser context</TD
+></TR
+></TABLE
+><P
+></P
+></DIV
+></DIV
+><HR><DIV
+CLASS="REFSECT2"
+><A
+NAME="AEN4171"
></A
><H3
><A
@@ -661,7 +1012,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4086"
+NAME="AEN4192"
></A
><H3
><A
@@ -747,7 +1098,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4109"
+NAME="AEN4215"
></A
><H3
><A
@@ -856,7 +1207,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4138"
+NAME="AEN4244"
></A
><H3
><A
@@ -941,7 +1292,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4161"
+NAME="AEN4267"
></A
><H3
><A
@@ -1022,7 +1373,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4182"
+NAME="AEN4288"
></A
><H3
><A
@@ -1089,7 +1440,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4199"
+NAME="AEN4305"
></A
><H3
><A
@@ -1177,7 +1528,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4223"
+NAME="AEN4329"
></A
><H3
><A
@@ -1262,7 +1613,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4246"
+NAME="AEN4352"
></A
><H3
><A
@@ -1346,7 +1697,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4268"
+NAME="AEN4374"
></A
><H3
><A
@@ -1430,7 +1781,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4290"
+NAME="AEN4396"
></A
><H3
><A
@@ -1513,7 +1864,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4312"
+NAME="AEN4418"
></A
><H3
><A
@@ -1596,7 +1947,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4334"
+NAME="AEN4440"
></A
><H3
><A
@@ -1680,7 +2031,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4355"
+NAME="AEN4461"
></A
><H3
><A
@@ -1811,7 +2162,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4388"
+NAME="AEN4494"
></A
><H3
><A
@@ -1918,7 +2269,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4415"
+NAME="AEN4521"
></A
><H3
><A
@@ -2001,7 +2352,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4437"
+NAME="AEN4543"
></A
><H3
><A
@@ -2068,7 +2419,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4455"
+NAME="AEN4561"
></A
><H3
><A
@@ -2143,7 +2494,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4475"
+NAME="AEN4581"
></A
><H3
><A
@@ -2218,7 +2569,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4497"
+NAME="AEN4603"
></A
><H3
><A
@@ -2329,7 +2680,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4526"
+NAME="AEN4632"
></A
><H3
><A
@@ -2414,7 +2765,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4549"
+NAME="AEN4655"
></A
><H3
><A
@@ -2497,7 +2848,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4571"
+NAME="AEN4677"
></A
><H3
><A
@@ -2600,7 +2951,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4598"
+NAME="AEN4704"
></A
><H3
><A
@@ -2706,7 +3057,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4626"
+NAME="AEN4732"
></A
><H3
><A
@@ -2773,7 +3124,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4644"
+NAME="AEN4750"
></A
><H3
><A
@@ -2865,7 +3216,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4668"
+NAME="AEN4774"
></A
><H3
><A
@@ -2957,7 +3308,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4693"
+NAME="AEN4799"
></A
><H3
><A
@@ -3080,7 +3431,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4724"
+NAME="AEN4830"
></A
><H3
><A
@@ -3162,7 +3513,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4746"
+NAME="AEN4852"
></A
><H3
><A
@@ -3230,7 +3581,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4764"
+NAME="AEN4870"
></A
><H3
><A
@@ -3317,7 +3668,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4787"
+NAME="AEN4893"
></A
><H3
><A
@@ -3400,7 +3751,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4809"
+NAME="AEN4915"
></A
><H3
><A
@@ -3484,7 +3835,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4831"
+NAME="AEN4937"
></A
><H3
><A
@@ -3567,7 +3918,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4853"
+NAME="AEN4959"
></A
><H3
><A
@@ -3633,7 +3984,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4870"
+NAME="AEN4976"
></A
><H3
><A
@@ -3746,7 +4097,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4901"
+NAME="AEN5007"
></A
><H3
><A
@@ -3838,7 +4189,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4927"
+NAME="AEN5033"
></A
><H3
><A
@@ -3951,7 +4302,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4957"
+NAME="AEN5063"
></A
><H3
><A
@@ -4022,7 +4373,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4977"
+NAME="AEN5083"
></A
><H3
><A
@@ -4087,7 +4438,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN4994"
+NAME="AEN5100"
></A
><H3
><A
@@ -4172,7 +4523,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN5017"
+NAME="AEN5123"
></A
><H3
><A
@@ -4255,7 +4606,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN5039"
+NAME="AEN5145"
></A
><H3
><A
@@ -4340,7 +4691,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN5062"
+NAME="AEN5168"
></A
><H3
><A
@@ -4423,7 +4774,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN5084"
+NAME="AEN5190"
></A
><H3
><A
@@ -4508,7 +4859,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN5107"
+NAME="AEN5213"
></A
><H3
><A
@@ -4589,7 +4940,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN5128"
+NAME="AEN5234"
></A
><H3
><A
@@ -4654,7 +5005,7 @@
><HR><DIV
CLASS="REFSECT2"
><A
-NAME="AEN5145"
+NAME="AEN5251"
></A
><H3
><A