Browse files

Finally - found the problem with the page generation (XMLPUBFUN not

* doc/html/*.html: Finally - found the problem with the
  page generation (XMLPUBFUN not recognized by gtkdoc).
  Re-created the pages using a temporary version of
  include/libxml/*.h.
* testOOMlib.c,include/libxml/encoding.h,
  include/libxml/schemasInternals.h,include/libxml/valid.h,
  include/libxml/xlink.h,include/libxml/xmlwin32version.h,
  include/libxml/xmlwin32version.h.in,
  include/libxml/xpathInternals.h: minor edit of comments
  to help automatic documentation generation
* doc/docdescr.doc: small elaboration
* doc/examples/test1.c,doc/examples/Makefile.am: re-commit
  (messed up on last try)
* xmlreader.c: minor change to clear warning.
  • Loading branch information...
1 parent 8d7b5c7 commit 60f394e96df5022a6145505bfbeb99815f65e7da William M. Brack committed Nov 16, 2003
Showing with 10,388 additions and 425 deletions.
  1. +17 −0 ChangeLog
  2. +6 −1 doc/docdescr.doc
  3. +1 −1 doc/examples/Makefile.am
  4. +1 −1 doc/examples/tree1.c
  5. +143 −2 doc/html/libxml-DOCBparser.html
  6. +450 −3 doc/html/libxml-HTMLparser.html
  7. +205 −2 doc/html/libxml-HTMLtree.html
  8. +216 −212 doc/html/libxml-SAX.html
  9. +130 −2 doc/html/libxml-c14n.html
  10. +295 −2 doc/html/libxml-catalog.html
  11. +69 −3 doc/html/libxml-chvalid.html
  12. +316 −2 doc/html/libxml-debugXML.html
  13. +60 −2 doc/html/libxml-dict.html
  14. +294 −16 doc/html/libxml-encoding.html
  15. +158 −1 doc/html/libxml-entities.html
  16. +183 −18 doc/html/libxml-globals.html
  17. +343 −2 doc/html/libxml-hash.html
  18. +197 −2 doc/html/libxml-list.html
  19. +191 −2 doc/html/libxml-nanoftp.html
  20. +82 −52 doc/html/libxml-nanohttp.html
  21. +1,075 −6 doc/html/libxml-parser.html
  22. +1,185 −2 doc/html/libxml-parserInternals.html
  23. +203 −2 doc/html/libxml-relaxng.html
  24. +7 −4 doc/html/libxml-schemasInternals.html
  25. +13 −10 doc/html/libxml-testOOMlib.html
  26. +83 −2 doc/html/libxml-threads.html
  27. +1,521 −2 doc/html/libxml-tree.html
  28. +115 −2 doc/html/libxml-uri.html
  29. +831 −3 doc/html/libxml-valid.html
  30. +1 −1 doc/html/libxml-wincecompat.html
  31. +1 −1 doc/html/libxml-wsockcompat.html
  32. +38 −2 doc/html/libxml-xinclude.html
  33. +458 −2 doc/html/libxml-xmlIO.html
  34. +232 −2 doc/html/libxml-xmlautomata.html
  35. +129 −1 doc/html/libxml-xmlerror.html
  36. +2 −6 doc/html/libxml-xmlexports.html
  37. +181 −2 doc/html/libxml-xmlmemory.html
  38. +701 −2 doc/html/libxml-xmlreader.html
  39. +85 −2 doc/html/libxml-xmlregexp.html
  40. +127 −2 doc/html/libxml-xmlschemas.html
  41. +43 −43 doc/html/libxml-xmlschemastypes.html
Sorry, we could not display the entire diff because it was too big.
View
17 ChangeLog
@@ -1,3 +1,20 @@
+Sun Nov 16 14:00:08 HKT 2003 William Brack <wbrack@mmm.com.hk>
+
+ * doc/html/*.html: Finally - found the problem with the
+ page generation (XMLPUBFUN not recognized by gtkdoc).
+ Re-created the pages using a temporary version of
+ include/libxml/*.h.
+ * testOOMlib.c,include/libxml/encoding.h,
+ include/libxml/schemasInternals.h,include/libxml/valid.h,
+ include/libxml/xlink.h,include/libxml/xmlwin32version.h,
+ include/libxml/xmlwin32version.h.in,
+ include/libxml/xpathInternals.h: minor edit of comments
+ to help automatic documentation generation
+ * doc/docdescr.doc: small elaboration
+ * doc/examples/test1.c,doc/examples/Makefile.am: re-commit
+ (messed up on last try)
+ * xmlreader.c: minor change to clear warning.
+
Sat Nov 15 19:20:32 CET 2003 Daniel Veillard <daniel@veillard.com>
* Copyright: fixed some wording
View
7 doc/docdescr.doc
@@ -54,6 +54,7 @@ NOTE: Steps 1 through 5 are performed with the command "make rebuild";
Steps 7 and 8 are performed with the command "make web"
1) Generate libxml-decl.txt, libxml-decl-list.txt and libxml-sections.txt:
+ make scan, or,
gtkdoc-scan --module=libxml --source-dir=../ \
--ignore-headers="acconfig.h config.h win32config.h trio.h triostr.h
triop.h config-m ac.h XMLTestPrefix2.h XMLTestPrefix.h
@@ -63,9 +64,11 @@ NOTE: Steps 1 through 5 are performed with the command "make rebuild";
These three files are used by the gdk-doc routines in the following steps.
2) Generate the sgml documentation in the subdirectory "tmpl":
+ make templates, or,
gtkdoc-mktmpl --module=libxml
3) Generate the xml documentation in the subdirectory "xml":
+ make xml, or,
gtkdoc-mkdb --module=libxml --source-dir=../ --output-format=xml \
--main-sgml-file=gnome-xml.xml
@@ -75,6 +78,7 @@ NOTE: Steps 1 through 5 are performed with the command "make rebuild";
titles.
4) Generate the main html documentation in the subdirectory "html":
+ make html, or,
cd html
gtkdoc-mkhtml libxml ../gnome-xml.xml
cd ../
@@ -101,7 +105,7 @@ NOTE: Steps 1 through 5 are performed with the command "make rebuild";
information on the api's in the file "libxml2-api.xml", but that step is
now being done by a separate script.
-7) Generate the site's main page:
+7) Generate the site's main pages:
xsltproc --nonet --html --output index.html site.xsl xml.html
All of the "top-level" pages (except xmlreader.html and guidelines.html)
@@ -114,6 +118,7 @@ NOTE: Steps 1 through 5 are performed with the command "make rebuild";
xsltproc --nonet --output ../NEWS news.xsl news.html
10)Generate the XML Software Autoupdate file libxml2.xsa:
+ make libxml2.xsa, or,
xsltproc --nonet --output libxml2.xsa xsa.xsl news.html
11)Manually generate xmlcatalog.1 and xmllint.1 using manpages/docbook.xsl
View
2 doc/examples/Makefile.am
@@ -19,7 +19,7 @@ install-data-local:
$(mkinstalldirs) $(DESTDIR)$(TARGET_DIR)
-@INSTALL@ -m 0644 $(srcdir)/*.html $(srcdir)/*.c $(srcdir)/*.xml $(srcdir)/*.xsl $(srcdir)/*.out $(DESTDIR)$(TARGET_DIR)
-EXTRA_DIST=examples.xsl index.py test1.xml examples.xml test2.xml tree1.out
+EXTRA_DIST=examples.xsl index.py examples.xml test1.xml test2.xml tree1.out
noinst_PROGRAMS=xpath1 parse1 parse2 tree1
View
2 doc/examples/tree1.c
@@ -25,7 +25,7 @@
* Prints the names of the all the xml elements
* that are siblings or children of a given xml node.
*/
-void
+static void
print_element_names(xmlNode * a_node)
{
xmlNode *cur_node = NULL;
View
145 doc/html/libxml-DOCBparser.html
@@ -28,7 +28,7 @@
.navigation .title {
font-size: 200%;
}
- </style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-xmlwin32version.html" title="xmlwin32version"><link rel="next" href="libxml-dict.html" title="dict"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xmlwin32version.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-dict.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-DOCBparser"></a><div class="titlepage"></div><div class="refnamediv"><h2>DOCBparser</h2><p>DOCBparser &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2605365"></a>Synopsis</h1></h2><pre class="synopsis">
+ </style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-xmlwin32version.html" title="xmlwin32version"><link rel="next" href="libxml-dict.html" title="dict"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xmlwin32version.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-dict.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-DOCBparser"></a><div class="titlepage"></div><div class="refnamediv"><h2>DOCBparser</h2><p>DOCBparser &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2671075"></a>Synopsis</h1></h2><pre class="synopsis">
@@ -39,6 +39,37 @@
typedef <a href="libxml-DOCBparser.html#docbParserInput">docbParserInput</a>;
typedef <a href="libxml-DOCBparser.html#docbParserInputPtr">docbParserInputPtr</a>;
typedef <a href="libxml-DOCBparser.html#docbDocPtr">docbDocPtr</a>;
+int <a href="libxml-DOCBparser.html#docbEncodeEntities">docbEncodeEntities</a> (unsigned char *out,
+ int *outlen,
+ unsigned char *in,
+ int *inlen,
+ int quoteChar);
+<a href="libxml-DOCBparser.html#docbDocPtr">docbDocPtr</a> <a href="libxml-DOCBparser.html#docbSAXParseDoc">docbSAXParseDoc</a> (<a href="libxml-tree.html#xmlChar">xmlChar</a> *cur,
+ const char *encoding,
+ <a href="libxml-DOCBparser.html#docbSAXHandlerPtr">docbSAXHandlerPtr</a> sax,
+ void *userData);
+<a href="libxml-DOCBparser.html#docbDocPtr">docbDocPtr</a> <a href="libxml-DOCBparser.html#docbParseDoc">docbParseDoc</a> (<a href="libxml-tree.html#xmlChar">xmlChar</a> *cur,
+ const char *encoding);
+<a href="libxml-DOCBparser.html#docbDocPtr">docbDocPtr</a> <a href="libxml-DOCBparser.html#docbSAXParseFile">docbSAXParseFile</a> (const char *filename,
+ const char *encoding,
+ <a href="libxml-DOCBparser.html#docbSAXHandlerPtr">docbSAXHandlerPtr</a> sax,
+ void *userData);
+<a href="libxml-DOCBparser.html#docbDocPtr">docbDocPtr</a> <a href="libxml-DOCBparser.html#docbParseFile">docbParseFile</a> (const char *filename,
+ const char *encoding);
+void <a href="libxml-DOCBparser.html#docbFreeParserCtxt">docbFreeParserCtxt</a> (<a href="libxml-DOCBparser.html#docbParserCtxtPtr">docbParserCtxtPtr</a> ctxt);
+<a href="libxml-DOCBparser.html#docbParserCtxtPtr">docbParserCtxtPtr</a> <a href="libxml-DOCBparser.html#docbCreatePushParserCtxt">docbCreatePushParserCtxt</a> (<a href="libxml-DOCBparser.html#docbSAXHandlerPtr">docbSAXHandlerPtr</a> sax,
+ void *user_data,
+ const char *chunk,
+ int size,
+ const char *filename,
+ <a href="libxml-encoding.html#xmlCharEncoding">xmlCharEncoding</a> enc);
+int <a href="libxml-DOCBparser.html#docbParseChunk">docbParseChunk</a> (<a href="libxml-DOCBparser.html#docbParserCtxtPtr">docbParserCtxtPtr</a> ctxt,
+ const char *chunk,
+ int size,
+ int terminate);
+<a href="libxml-DOCBparser.html#docbParserCtxtPtr">docbParserCtxtPtr</a> <a href="libxml-DOCBparser.html#docbCreateFileParserCtxt">docbCreateFileParserCtxt</a> (const char *filename,
+ const char *encoding);
+int <a href="libxml-DOCBparser.html#docbParseDocument">docbParseDocument</a> (<a href="libxml-DOCBparser.html#docbParserCtxtPtr">docbParserCtxtPtr</a> ctxt);
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="docbParserCtxt"></a>docbParserCtxt</h3><pre class="programlisting">typedef xmlParserCtxt docbParserCtxt;
@@ -62,4 +93,114 @@
</p></div><hr><div class="refsect2"><h3><a name="docbDocPtr"></a>docbDocPtr</h3><pre class="programlisting">typedef xmlDocPtr docbDocPtr;
</pre><p>
-</p></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-xmlwin32version.html"><b>&lt;&lt; xmlwin32version</b></a></td><td align="right"><a accesskey="n" href="libxml-dict.html"><b>dict &gt;&gt;</b></a></td></tr></table></body></html>
+</p></div><hr><div class="refsect2"><h3><a name="docbEncodeEntities"></a>docbEncodeEntities ()</h3><pre class="programlisting">int docbEncodeEntities (unsigned char *out,
+ int *outlen,
+ unsigned char *in,
+ int *inlen,
+ int quoteChar);</pre><p>
+Take a block of UTF-8 chars in and try to convert it to an ASCII
+plus SGML entities block of chars out.</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>out</tt></i>:</span></td><td> a pointer to an array of bytes to store the result
+</td></tr><tr><td><span class="term"><i><tt>outlen</tt></i>:</span></td><td> the length of <i><tt>out</tt></i>
+</td></tr><tr><td><span class="term"><i><tt>in</tt></i>:</span></td><td> a pointer to an array of UTF-8 chars
+</td></tr><tr><td><span class="term"><i><tt>inlen</tt></i>:</span></td><td> the length of <i><tt>in</tt></i>
+</td></tr><tr><td><span class="term"><i><tt>quoteChar</tt></i>:</span></td><td> the quote character to escape (' or ") or zero.
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 if success, -2 if the transcoding fails, or -1 otherwise
+The value of <i><tt>inlen</tt></i> after return is the number of octets consumed
+ as the return value is positive, else unpredictable.
+The value of <i><tt>outlen</tt></i> after return is the number of octets consumed.
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="docbSAXParseDoc"></a>docbSAXParseDoc ()</h3><pre class="programlisting"><a href="libxml-DOCBparser.html#docbDocPtr">docbDocPtr</a> docbSAXParseDoc (<a href="libxml-tree.html#xmlChar">xmlChar</a> *cur,
+ const char *encoding,
+ <a href="libxml-DOCBparser.html#docbSAXHandlerPtr">docbSAXHandlerPtr</a> sax,
+ void *userData);</pre><p>
+parse an SGML 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><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> a pointer to an array of xmlChar
+</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> a free form C string describing the SGML document encoding, or NULL
+</td></tr><tr><td><span class="term"><i><tt>sax</tt></i>:</span></td><td> the SAX handler block
+</td></tr><tr><td><span class="term"><i><tt>userData</tt></i>:</span></td><td> if using SAX, this pointer will be provided on callbacks.
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="docbParseDoc"></a>docbParseDoc ()</h3><pre class="programlisting"><a href="libxml-DOCBparser.html#docbDocPtr">docbDocPtr</a> docbParseDoc (<a href="libxml-tree.html#xmlChar">xmlChar</a> *cur,
+ const char *encoding);</pre><p>
+parse an SGML in-memory document and build a tree.</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> a pointer to an array of xmlChar
+</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> a free form C string describing the SGML document encoding, or NULL
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="docbSAXParseFile"></a>docbSAXParseFile ()</h3><pre class="programlisting"><a href="libxml-DOCBparser.html#docbDocPtr">docbDocPtr</a> docbSAXParseFile (const char *filename,
+ const char *encoding,
+ <a href="libxml-DOCBparser.html#docbSAXHandlerPtr">docbSAXHandlerPtr</a> sax,
+ void *userData);</pre><p>
+parse an SGML file and build a tree. Automatic support for ZLIB/Compress
+compressed document is provided by default if found at compile-time.
+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><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> the filename
+</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> a free form C string describing the SGML document encoding, or NULL
+</td></tr><tr><td><span class="term"><i><tt>sax</tt></i>:</span></td><td> the SAX handler block
+</td></tr><tr><td><span class="term"><i><tt>userData</tt></i>:</span></td><td> if using SAX, this pointer will be provided on callbacks.
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="docbParseFile"></a>docbParseFile ()</h3><pre class="programlisting"><a href="libxml-DOCBparser.html#docbDocPtr">docbDocPtr</a> docbParseFile (const char *filename,
+ const char *encoding);</pre><p>
+parse a Docbook SGML file and build a tree. Automatic support for
+ZLIB/Compress compressed document is provided by default if found
+at compile-time.</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> the filename
+</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> a free form C string describing document encoding, or NULL
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="docbFreeParserCtxt"></a>docbFreeParserCtxt ()</h3><pre class="programlisting">void docbFreeParserCtxt (<a href="libxml-DOCBparser.html#docbParserCtxtPtr">docbParserCtxtPtr</a> ctxt);</pre><p>
+Free all the memory used by a parser context. However the parsed
+document in ctxt-&gt;myDoc is not freed.</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> an SGML parser context
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="docbCreatePushParserCtxt"></a>docbCreatePushParserCtxt ()</h3><pre class="programlisting"><a href="libxml-DOCBparser.html#docbParserCtxtPtr">docbParserCtxtPtr</a> docbCreatePushParserCtxt (<a href="libxml-DOCBparser.html#docbSAXHandlerPtr">docbSAXHandlerPtr</a> sax,
+ void *user_data,
+ const char *chunk,
+ int size,
+ const char *filename,
+ <a href="libxml-encoding.html#xmlCharEncoding">xmlCharEncoding</a> enc);</pre><p>
+Create a parser context for using the DocBook SGML parser in push mode
+To allow content encoding detection, <i><tt>size</tt></i> should be &gt;= 4
+The value of <i><tt>filename</tt></i> is used for fetching external entities
+and error/warning reports.</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>sax</tt></i>:</span></td><td> a SAX handler
+</td></tr><tr><td><span class="term"><i><tt>user_data</tt></i>:</span></td><td> The user data returned on SAX callbacks
+</td></tr><tr><td><span class="term"><i><tt>chunk</tt></i>:</span></td><td> a pointer to an array of chars
+</td></tr><tr><td><span class="term"><i><tt>size</tt></i>:</span></td><td> number of chars in the array
+</td></tr><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> an optional file name or URI
+</td></tr><tr><td><span class="term"><i><tt>enc</tt></i>:</span></td><td> an optional encoding
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new parser context or NULL
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="docbParseChunk"></a>docbParseChunk ()</h3><pre class="programlisting">int docbParseChunk (<a href="libxml-DOCBparser.html#docbParserCtxtPtr">docbParserCtxtPtr</a> ctxt,
+ const char *chunk,
+ int size,
+ int terminate);</pre><p>
+Parse a Chunk of memory</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> an XML parser context
+</td></tr><tr><td><span class="term"><i><tt>chunk</tt></i>:</span></td><td> an char array
+</td></tr><tr><td><span class="term"><i><tt>size</tt></i>:</span></td><td> the size in byte of the chunk
+</td></tr><tr><td><span class="term"><i><tt>terminate</tt></i>:</span></td><td> last chunk indicator
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>zero if no error, the xmlParserErrors otherwise.
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="docbCreateFileParserCtxt"></a>docbCreateFileParserCtxt ()</h3><pre class="programlisting"><a href="libxml-DOCBparser.html#docbParserCtxtPtr">docbParserCtxtPtr</a> docbCreateFileParserCtxt (const char *filename,
+ const char *encoding);</pre><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="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> the filename
+</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the SGML document encoding, or NULL
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new parser context or NULL
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="docbParseDocument"></a>docbParseDocument ()</h3><pre class="programlisting">int docbParseDocument (<a href="libxml-DOCBparser.html#docbParserCtxtPtr">docbParserCtxtPtr</a> ctxt);</pre><p>
+parse an SGML document (and build a tree if using the standard SAX
+interface).</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> an SGML parser context
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0, -1 in case of error. the parser context is augmented
+ as a result of the parsing.
+</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-xmlwin32version.html"><b>&lt;&lt; xmlwin32version</b></a></td><td align="right"><a accesskey="n" href="libxml-dict.html"><b>dict &gt;&gt;</b></a></td></tr></table></body></html>
View
453 doc/html/libxml-HTMLparser.html
@@ -28,7 +28,7 @@
.navigation .title {
font-size: 200%;
}
- </style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-entities.html" title="entities"><link rel="next" href="libxml-valid.html" title="valid"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-entities.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-valid.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-HTMLparser"></a><div class="titlepage"></div><div class="refnamediv"><h2>HTMLparser</h2><p>HTMLparser &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2684037"></a>Synopsis</h1></h2><pre class="synopsis">
+ </style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-entities.html" title="entities"><link rel="next" href="libxml-valid.html" title="valid"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-entities.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-valid.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-HTMLparser"></a><div class="titlepage"></div><div class="refnamediv"><h2>HTMLparser</h2><p>HTMLparser &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2762484"></a>Synopsis</h1></h2><pre class="synopsis">
@@ -45,7 +45,109 @@
typedef <a href="libxml-HTMLparser.html#htmlElemDescPtr">htmlElemDescPtr</a>;
struct <a href="libxml-HTMLparser.html#htmlEntityDesc">htmlEntityDesc</a>;
typedef <a href="libxml-HTMLparser.html#htmlEntityDescPtr">htmlEntityDescPtr</a>;
+const <a href="libxml-HTMLparser.html#htmlElemDesc">htmlElemDesc</a>* <a href="libxml-HTMLparser.html#htmlTagLookup">htmlTagLookup</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *tag);
+const <a href="libxml-HTMLparser.html#htmlEntityDesc">htmlEntityDesc</a>* <a href="libxml-HTMLparser.html#htmlEntityLookup">htmlEntityLookup</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);
+const <a href="libxml-HTMLparser.html#htmlEntityDesc">htmlEntityDesc</a>* <a href="libxml-HTMLparser.html#htmlEntityValueLookup">htmlEntityValueLookup</a> (unsigned int value);
+int <a href="libxml-HTMLparser.html#htmlIsAutoClosed">htmlIsAutoClosed</a> (<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> doc,
+ <a href="libxml-HTMLparser.html#htmlNodePtr">htmlNodePtr</a> elem);
+int <a href="libxml-HTMLparser.html#htmlAutoCloseTag">htmlAutoCloseTag</a> (<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> doc,
+ const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
+ <a href="libxml-HTMLparser.html#htmlNodePtr">htmlNodePtr</a> elem);
+const <a href="libxml-HTMLparser.html#htmlEntityDesc">htmlEntityDesc</a>* <a href="libxml-HTMLparser.html#htmlParseEntityRef">htmlParseEntityRef</a> (<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> ctxt,
+ const <a href="libxml-tree.html#xmlChar">xmlChar</a> **str);
+int <a href="libxml-HTMLparser.html#htmlParseCharRef">htmlParseCharRef</a> (<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> ctxt);
+void <a href="libxml-HTMLparser.html#htmlParseElement">htmlParseElement</a> (<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> ctxt);
+<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> <a href="libxml-HTMLparser.html#htmlCreateMemoryParserCtxt">htmlCreateMemoryParserCtxt</a>
+ (const char *buffer,
+ int size);
+int <a href="libxml-HTMLparser.html#htmlParseDocument">htmlParseDocument</a> (<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> ctxt);
+<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> <a href="libxml-HTMLparser.html#htmlSAXParseDoc">htmlSAXParseDoc</a> (<a href="libxml-tree.html#xmlChar">xmlChar</a> *cur,
+ const char *encoding,
+ <a href="libxml-HTMLparser.html#htmlSAXHandlerPtr">htmlSAXHandlerPtr</a> sax,
+ void *userData);
+<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> <a href="libxml-HTMLparser.html#htmlParseDoc">htmlParseDoc</a> (<a href="libxml-tree.html#xmlChar">xmlChar</a> *cur,
+ const char *encoding);
+<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> <a href="libxml-HTMLparser.html#htmlSAXParseFile">htmlSAXParseFile</a> (const char *filename,
+ const char *encoding,
+ <a href="libxml-HTMLparser.html#htmlSAXHandlerPtr">htmlSAXHandlerPtr</a> sax,
+ void *userData);
+<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> <a href="libxml-HTMLparser.html#htmlParseFile">htmlParseFile</a> (const char *filename,
+ const char *encoding);
+int <a href="libxml-HTMLparser.html#UTF8ToHtml">UTF8ToHtml</a> (unsigned char *out,
+ int *outlen,
+ unsigned char *in,
+ int *inlen);
+int <a href="libxml-HTMLparser.html#htmlEncodeEntities">htmlEncodeEntities</a> (unsigned char *out,
+ int *outlen,
+ unsigned char *in,
+ int *inlen,
+ int quoteChar);
+int <a href="libxml-HTMLparser.html#htmlIsScriptAttribute">htmlIsScriptAttribute</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);
+int <a href="libxml-HTMLparser.html#htmlHandleOmittedElem">htmlHandleOmittedElem</a> (int val);
+<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> <a href="libxml-HTMLparser.html#htmlCreatePushParserCtxt">htmlCreatePushParserCtxt</a> (<a href="libxml-HTMLparser.html#htmlSAXHandlerPtr">htmlSAXHandlerPtr</a> sax,
+ void *user_data,
+ const char *chunk,
+ int size,
+ const char *filename,
+ <a href="libxml-encoding.html#xmlCharEncoding">xmlCharEncoding</a> enc);
+int <a href="libxml-HTMLparser.html#htmlParseChunk">htmlParseChunk</a> (<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> ctxt,
+ const char *chunk,
+ int size,
+ int terminate);
+void <a href="libxml-HTMLparser.html#htmlFreeParserCtxt">htmlFreeParserCtxt</a> (<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> ctxt);
enum <a href="libxml-HTMLparser.html#htmlParserOption">htmlParserOption</a>;
+void <a href="libxml-HTMLparser.html#htmlCtxtReset">htmlCtxtReset</a> (<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> ctxt);
+int <a href="libxml-HTMLparser.html#htmlCtxtUseOptions">htmlCtxtUseOptions</a> (<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> ctxt,
+ int options);
+<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> <a href="libxml-HTMLparser.html#htmlReadDoc">htmlReadDoc</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *cur,
+ const char *URL,
+ const char *encoding,
+ int options);
+<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> <a href="libxml-HTMLparser.html#htmlReadFile">htmlReadFile</a> (const char *URL,
+ const char *encoding,
+ int options);
+<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> <a href="libxml-HTMLparser.html#htmlReadMemory">htmlReadMemory</a> (const char *buffer,
+ int size,
+ const char *URL,
+ const char *encoding,
+ int options);
+<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> <a href="libxml-HTMLparser.html#htmlReadFd">htmlReadFd</a> (int fd,
+ const char *URL,
+ const char *encoding,
+ int options);
+<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> <a href="libxml-HTMLparser.html#htmlReadIO">htmlReadIO</a> (<a href="libxml-xmlIO.html#xmlInputReadCallback">xmlInputReadCallback</a> ioread,
+ <a href="libxml-xmlIO.html#xmlInputCloseCallback">xmlInputCloseCallback</a> ioclose,
+ void *ioctx,
+ const char *URL,
+ const char *encoding,
+ int options);
+<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> <a href="libxml-HTMLparser.html#htmlCtxtReadDoc">htmlCtxtReadDoc</a> (<a href="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt,
+ const <a href="libxml-tree.html#xmlChar">xmlChar</a> *cur,
+ const char *URL,
+ const char *encoding,
+ int options);
+<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> <a href="libxml-HTMLparser.html#htmlCtxtReadFile">htmlCtxtReadFile</a> (<a href="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt,
+ const char *filename,
+ const char *encoding,
+ int options);
+<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> <a href="libxml-HTMLparser.html#htmlCtxtReadMemory">htmlCtxtReadMemory</a> (<a href="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt,
+ const char *buffer,
+ int size,
+ const char *URL,
+ const char *encoding,
+ int options);
+<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> <a href="libxml-HTMLparser.html#htmlCtxtReadFd">htmlCtxtReadFd</a> (<a href="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt,
+ int fd,
+ const char *URL,
+ const char *encoding,
+ int options);
+<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> <a href="libxml-HTMLparser.html#htmlCtxtReadIO">htmlCtxtReadIO</a> (<a href="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt,
+ <a href="libxml-xmlIO.html#xmlInputReadCallback">xmlInputReadCallback</a> ioread,
+ <a href="libxml-xmlIO.html#xmlInputCloseCallback">xmlInputCloseCallback</a> ioclose,
+ void *ioctx,
+ const char *URL,
+ const char *encoding,
+ int options);
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="htmlParserCtxt"></a>htmlParserCtxt</h3><pre class="programlisting">typedef xmlParserCtxt htmlParserCtxt;
@@ -120,7 +222,207 @@
</p></div><hr><div class="refsect2"><h3><a name="htmlEntityDescPtr"></a>htmlEntityDescPtr</h3><pre class="programlisting">typedef htmlEntityDesc *htmlEntityDescPtr;
</pre><p>
-</p></div><hr><div class="refsect2"><h3><a name="htmlParserOption"></a>enum htmlParserOption</h3><pre class="programlisting">typedef enum {
+</p></div><hr><div class="refsect2"><h3><a name="htmlTagLookup"></a>htmlTagLookup ()</h3><pre class="programlisting">const <a href="libxml-HTMLparser.html#htmlElemDesc">htmlElemDesc</a>* htmlTagLookup (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *tag);</pre><p>
+Lookup the HTML tag in the ElementTable</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>tag</tt></i>:</span></td><td> The tag name in lowercase
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the related htmlElemDescPtr or NULL if not found.
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlEntityLookup"></a>htmlEntityLookup ()</h3><pre class="programlisting">const <a href="libxml-HTMLparser.html#htmlEntityDesc">htmlEntityDesc</a>* htmlEntityLookup (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
+Lookup the given entity in EntitiesTable
+</p><p>
+TODO: the linear scan is really ugly, an hash table is really needed.</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the entity name
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the associated htmlEntityDescPtr if found, NULL otherwise.
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlEntityValueLookup"></a>htmlEntityValueLookup ()</h3><pre class="programlisting">const <a href="libxml-HTMLparser.html#htmlEntityDesc">htmlEntityDesc</a>* htmlEntityValueLookup (unsigned int value);</pre><p>
+Lookup the given entity in EntitiesTable
+</p><p>
+TODO: the linear scan is really ugly, an hash table is really needed.</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>value</tt></i>:</span></td><td> the entity's unicode value
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the associated htmlEntityDescPtr if found, NULL otherwise.
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlIsAutoClosed"></a>htmlIsAutoClosed ()</h3><pre class="programlisting">int htmlIsAutoClosed (<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> doc,
+ <a href="libxml-HTMLparser.html#htmlNodePtr">htmlNodePtr</a> elem);</pre><p>
+The HTML DTD allows a tag to implicitly close other tags.
+The list is kept in htmlStartClose array. This function checks
+if a tag is autoclosed by one of it's child</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the HTML document
+</td></tr><tr><td><span class="term"><i><tt>elem</tt></i>:</span></td><td> the HTML element
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if autoclosed, 0 otherwise
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlAutoCloseTag"></a>htmlAutoCloseTag ()</h3><pre class="programlisting">int htmlAutoCloseTag (<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> doc,
+ const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
+ <a href="libxml-HTMLparser.html#htmlNodePtr">htmlNodePtr</a> elem);</pre><p>
+The HTML DTD allows a tag to implicitly close other tags.
+The list is kept in htmlStartClose array. This function checks
+if the element or one of it's children would autoclose the
+given tag.</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the HTML document
+</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> The tag name
+</td></tr><tr><td><span class="term"><i><tt>elem</tt></i>:</span></td><td> the HTML element
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if autoclose, 0 otherwise
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlParseEntityRef"></a>htmlParseEntityRef ()</h3><pre class="programlisting">const <a href="libxml-HTMLparser.html#htmlEntityDesc">htmlEntityDesc</a>* htmlParseEntityRef (<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> ctxt,
+ const <a href="libxml-tree.html#xmlChar">xmlChar</a> **str);</pre><p>
+parse an HTML ENTITY references
+</p><p>
+[68] EntityRef ::= '&amp;' Name ';'</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> an HTML parser context
+</td></tr><tr><td><span class="term"><i><tt>str</tt></i>:</span></td><td> location to store the entity name
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><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></div></div><hr><div class="refsect2"><h3><a name="htmlParseCharRef"></a>htmlParseCharRef ()</h3><pre class="programlisting">int htmlParseCharRef (<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> ctxt);</pre><p>
+parse Reference declarations
+</p><p>
+[66] CharRef ::= '&amp;#' [0-9]+ ';' |
+ '&amp;<GTKDOCLINK HREF="x">x</GTKDOCLINK>' [0-9a-fA-F]+ ';'</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> an HTML parser context
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the value parsed (as an int)
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlParseElement"></a>htmlParseElement ()</h3><pre class="programlisting">void htmlParseElement (<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> ctxt);</pre><p>
+parse an HTML element, this is highly recursive
+</p><p>
+[39] element ::= EmptyElemTag | STag content ETag
+</p><p>
+[41] Attribute ::= Name Eq AttValue</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> an HTML parser context
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlCreateMemoryParserCtxt"></a>htmlCreateMemoryParserCtxt ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> htmlCreateMemoryParserCtxt
+ (const char *buffer,
+ int size);</pre><p>
+Create a parser context for an HTML in-memory document.</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>buffer</tt></i>:</span></td><td> a pointer to a char array
+</td></tr><tr><td><span class="term"><i><tt>size</tt></i>:</span></td><td> the size of the array
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new parser context or NULL
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlParseDocument"></a>htmlParseDocument ()</h3><pre class="programlisting">int htmlParseDocument (<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> ctxt);</pre><p>
+parse an HTML document (and build a tree if using the standard SAX
+interface).</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> an HTML parser context
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0, -1 in case of error. the parser context is augmented
+ as a result of the parsing.
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlSAXParseDoc"></a>htmlSAXParseDoc ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> htmlSAXParseDoc (<a href="libxml-tree.html#xmlChar">xmlChar</a> *cur,
+ const char *encoding,
+ <a href="libxml-HTMLparser.html#htmlSAXHandlerPtr">htmlSAXHandlerPtr</a> sax,
+ void *userData);</pre><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="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> a pointer to an array of xmlChar
+</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> a free form C string describing the HTML document encoding, or NULL
+</td></tr><tr><td><span class="term"><i><tt>sax</tt></i>:</span></td><td> the SAX handler block
+</td></tr><tr><td><span class="term"><i><tt>userData</tt></i>:</span></td><td> if using SAX, this pointer will be provided on callbacks.
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree unless SAX is NULL or the document is
+ not well formed.
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlParseDoc"></a>htmlParseDoc ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> htmlParseDoc (<a href="libxml-tree.html#xmlChar">xmlChar</a> *cur,
+ const char *encoding);</pre><p>
+parse an HTML in-memory document and build a tree.</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> a pointer to an array of xmlChar
+</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> a free form C string describing the HTML document encoding, or NULL
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlSAXParseFile"></a>htmlSAXParseFile ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> htmlSAXParseFile (const char *filename,
+ const char *encoding,
+ <a href="libxml-HTMLparser.html#htmlSAXHandlerPtr">htmlSAXHandlerPtr</a> sax,
+ void *userData);</pre><p>
+parse an HTML file and build a tree. Automatic support for ZLIB/Compress
+compressed document is provided by default if found at compile-time.
+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><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> the filename
+</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> a free form C string describing the HTML document encoding, or NULL
+</td></tr><tr><td><span class="term"><i><tt>sax</tt></i>:</span></td><td> the SAX handler block
+</td></tr><tr><td><span class="term"><i><tt>userData</tt></i>:</span></td><td> if using SAX, this pointer will be provided on callbacks.
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree unless SAX is NULL or the document is
+ not well formed.
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlParseFile"></a>htmlParseFile ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> htmlParseFile (const char *filename,
+ const char *encoding);</pre><p>
+parse an HTML file and build a tree. Automatic support for ZLIB/Compress
+compressed document is provided by default if found at compile-time.</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> the filename
+</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> a free form C string describing the HTML document encoding, or NULL
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="UTF8ToHtml"></a>UTF8ToHtml ()</h3><pre class="programlisting">int UTF8ToHtml (unsigned char *out,
+ int *outlen,
+ unsigned char *in,
+ int *inlen);</pre><p>
+Take a block of UTF-8 chars in and try to convert it to an ASCII
+plus HTML entities block of chars out.</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>out</tt></i>:</span></td><td> a pointer to an array of bytes to store the result
+</td></tr><tr><td><span class="term"><i><tt>outlen</tt></i>:</span></td><td> the length of <i><tt>out</tt></i>
+</td></tr><tr><td><span class="term"><i><tt>in</tt></i>:</span></td><td> a pointer to an array of UTF-8 chars
+</td></tr><tr><td><span class="term"><i><tt>inlen</tt></i>:</span></td><td> the length of <i><tt>in</tt></i>
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 if success, -2 if the transcoding fails, or -1 otherwise
+The value of <i><tt>inlen</tt></i> after return is the number of octets consumed
+ as the return value is positive, else unpredictable.
+The value of <i><tt>outlen</tt></i> after return is the number of octets consumed.
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlEncodeEntities"></a>htmlEncodeEntities ()</h3><pre class="programlisting">int htmlEncodeEntities (unsigned char *out,
+ int *outlen,
+ unsigned char *in,
+ int *inlen,
+ int quoteChar);</pre><p>
+Take a block of UTF-8 chars in and try to convert it to an ASCII
+plus HTML entities block of chars out.</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>out</tt></i>:</span></td><td> a pointer to an array of bytes to store the result
+</td></tr><tr><td><span class="term"><i><tt>outlen</tt></i>:</span></td><td> the length of <i><tt>out</tt></i>
+</td></tr><tr><td><span class="term"><i><tt>in</tt></i>:</span></td><td> a pointer to an array of UTF-8 chars
+</td></tr><tr><td><span class="term"><i><tt>inlen</tt></i>:</span></td><td> the length of <i><tt>in</tt></i>
+</td></tr><tr><td><span class="term"><i><tt>quoteChar</tt></i>:</span></td><td> the quote character to escape (' or ") or zero.
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 if success, -2 if the transcoding fails, or -1 otherwise
+The value of <i><tt>inlen</tt></i> after return is the number of octets consumed
+ as the return value is positive, else unpredictable.
+The value of <i><tt>outlen</tt></i> after return is the number of octets consumed.
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlIsScriptAttribute"></a>htmlIsScriptAttribute ()</h3><pre class="programlisting">int htmlIsScriptAttribute (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
+Check if an attribute is of content type Script</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> an attribute name
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 is the attribute is a script 0 otherwise
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlHandleOmittedElem"></a>htmlHandleOmittedElem ()</h3><pre class="programlisting">int htmlHandleOmittedElem (int val);</pre><p>
+Set and return the previous value for handling HTML omitted tags.</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>val</tt></i>:</span></td><td> int 0 or 1
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the last value for 0 for no handling, 1 for auto insertion.
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlCreatePushParserCtxt"></a>htmlCreatePushParserCtxt ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> htmlCreatePushParserCtxt (<a href="libxml-HTMLparser.html#htmlSAXHandlerPtr">htmlSAXHandlerPtr</a> sax,
+ void *user_data,
+ const char *chunk,
+ int size,
+ const char *filename,
+ <a href="libxml-encoding.html#xmlCharEncoding">xmlCharEncoding</a> enc);</pre><p>
+Create a parser context for using the HTML parser in push mode
+The value of <i><tt>filename</tt></i> is used for fetching external entities
+and error/warning reports.</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>sax</tt></i>:</span></td><td> a SAX handler
+</td></tr><tr><td><span class="term"><i><tt>user_data</tt></i>:</span></td><td> The user data returned on SAX callbacks
+</td></tr><tr><td><span class="term"><i><tt>chunk</tt></i>:</span></td><td> a pointer to an array of chars
+</td></tr><tr><td><span class="term"><i><tt>size</tt></i>:</span></td><td> number of chars in the array
+</td></tr><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> an optional file name or URI
+</td></tr><tr><td><span class="term"><i><tt>enc</tt></i>:</span></td><td> an optional encoding
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new parser context or NULL
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlParseChunk"></a>htmlParseChunk ()</h3><pre class="programlisting">int htmlParseChunk (<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> ctxt,
+ const char *chunk,
+ int size,
+ int terminate);</pre><p>
+Parse a Chunk of memory</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> an HTML parser context
+</td></tr><tr><td><span class="term"><i><tt>chunk</tt></i>:</span></td><td> an char array
+</td></tr><tr><td><span class="term"><i><tt>size</tt></i>:</span></td><td> the size in byte of the chunk
+</td></tr><tr><td><span class="term"><i><tt>terminate</tt></i>:</span></td><td> last chunk indicator
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>zero if no error, the xmlParserErrors otherwise.
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlFreeParserCtxt"></a>htmlFreeParserCtxt ()</h3><pre class="programlisting">void htmlFreeParserCtxt (<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> ctxt);</pre><p>
+Free all the memory used by a parser context. However the parsed
+document in ctxt-&gt;myDoc is not freed.</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> an HTML parser context
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlParserOption"></a>enum htmlParserOption</h3><pre class="programlisting">typedef enum {
HTML_PARSE_NOERROR = 1&lt;&lt;5, /* suppress error reports */
HTML_PARSE_NOWARNING= 1&lt;&lt;6, /* suppress warning reports */
HTML_PARSE_PEDANTIC = 1&lt;&lt;7, /* pedantic error reporting */
@@ -129,4 +431,149 @@
} htmlParserOption;
</pre><p>
-</p></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-entities.html"><b>&lt;&lt; entities</b></a></td><td align="right"><a accesskey="n" href="libxml-valid.html"><b>valid &gt;&gt;</b></a></td></tr></table></body></html>
+</p></div><hr><div class="refsect2"><h3><a name="htmlCtxtReset"></a>htmlCtxtReset ()</h3><pre class="programlisting">void htmlCtxtReset (<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> ctxt);</pre><p>
+Reset a parser context</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> an HTML parser context
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlCtxtUseOptions"></a>htmlCtxtUseOptions ()</h3><pre class="programlisting">int htmlCtxtUseOptions (<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> ctxt,
+ int options);</pre><p>
+Applies the options to the parser context</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> an HTML parser context
+</td></tr><tr><td><span class="term"><i><tt>options</tt></i>:</span></td><td> a combination of htmlParserOption(s)
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 in case of success, the set of unknown or unimplemented options
+ in case of error.
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlReadDoc"></a>htmlReadDoc ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> htmlReadDoc (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *cur,
+ const char *URL,
+ const char *encoding,
+ int options);</pre><p>
+parse an XML in-memory document and build a tree.</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> a pointer to a zero terminated string
+</td></tr><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> the base URL to use for the document
+</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding, or NULL
+</td></tr><tr><td><span class="term"><i><tt>options</tt></i>:</span></td><td> a combination of htmlParserOption(s)
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlReadFile"></a>htmlReadFile ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> htmlReadFile (const char *URL,
+ const char *encoding,
+ int options);</pre><p>
+parse an XML file from the filesystem or the network.</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td>
+</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding, or NULL
+</td></tr><tr><td><span class="term"><i><tt>options</tt></i>:</span></td><td> a combination of htmlParserOption(s)
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlReadMemory"></a>htmlReadMemory ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> htmlReadMemory (const char *buffer,
+ int size,
+ const char *URL,
+ const char *encoding,
+ int options);</pre><p>
+parse an XML in-memory document and build a tree.</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>buffer</tt></i>:</span></td><td> a pointer to a char array
+</td></tr><tr><td><span class="term"><i><tt>size</tt></i>:</span></td><td> the size of the array
+</td></tr><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> the base URL to use for the document
+</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding, or NULL
+</td></tr><tr><td><span class="term"><i><tt>options</tt></i>:</span></td><td> a combination of htmlParserOption(s)
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlReadFd"></a>htmlReadFd ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> htmlReadFd (int fd,
+ const char *URL,
+ const char *encoding,
+ int options);</pre><p>
+parse an XML from a file descriptor and build a tree.</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>fd</tt></i>:</span></td><td> an open file descriptor
+</td></tr><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> the base URL to use for the document
+</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding, or NULL
+</td></tr><tr><td><span class="term"><i><tt>options</tt></i>:</span></td><td> a combination of htmlParserOption(s)
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlReadIO"></a>htmlReadIO ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> htmlReadIO (<a href="libxml-xmlIO.html#xmlInputReadCallback">xmlInputReadCallback</a> ioread,
+ <a href="libxml-xmlIO.html#xmlInputCloseCallback">xmlInputCloseCallback</a> ioclose,
+ void *ioctx,
+ const char *URL,
+ const char *encoding,
+ int options);</pre><p>
+parse an HTML document from I/O functions and source and build a tree.</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ioread</tt></i>:</span></td><td> an I/O read function
+</td></tr><tr><td><span class="term"><i><tt>ioclose</tt></i>:</span></td><td> an I/O close function
+</td></tr><tr><td><span class="term"><i><tt>ioctx</tt></i>:</span></td><td> an I/O handler
+</td></tr><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> the base URL to use for the document
+</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding, or NULL
+</td></tr><tr><td><span class="term"><i><tt>options</tt></i>:</span></td><td> a combination of htmlParserOption(s)
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlCtxtReadDoc"></a>htmlCtxtReadDoc ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> htmlCtxtReadDoc (<a href="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt,
+ const <a href="libxml-tree.html#xmlChar">xmlChar</a> *cur,
+ const char *URL,
+ const char *encoding,
+ int options);</pre><p>
+parse an XML in-memory document and build a tree.
+This reuses the existing <i><tt>ctxt</tt></i> parser context</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> an HTML parser context
+</td></tr><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> a pointer to a zero terminated string
+</td></tr><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> the base URL to use for the document
+</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding, or NULL
+</td></tr><tr><td><span class="term"><i><tt>options</tt></i>:</span></td><td> a combination of htmlParserOption(s)
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlCtxtReadFile"></a>htmlCtxtReadFile ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> htmlCtxtReadFile (<a href="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt,
+ const char *filename,
+ const char *encoding,
+ int options);</pre><p>
+parse an XML file from the filesystem or the network.
+This reuses the existing <i><tt>ctxt</tt></i> parser context</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> an HTML parser context
+</td></tr><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> a file or URL
+</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding, or NULL
+</td></tr><tr><td><span class="term"><i><tt>options</tt></i>:</span></td><td> a combination of htmlParserOption(s)
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlCtxtReadMemory"></a>htmlCtxtReadMemory ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> htmlCtxtReadMemory (<a href="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt,
+ const char *buffer,
+ int size,
+ const char *URL,
+ const char *encoding,
+ int options);</pre><p>
+parse an XML in-memory document and build a tree.
+This reuses the existing <i><tt>ctxt</tt></i> parser context</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> an HTML parser context
+</td></tr><tr><td><span class="term"><i><tt>buffer</tt></i>:</span></td><td> a pointer to a char array
+</td></tr><tr><td><span class="term"><i><tt>size</tt></i>:</span></td><td> the size of the array
+</td></tr><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> the base URL to use for the document
+</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding, or NULL
+</td></tr><tr><td><span class="term"><i><tt>options</tt></i>:</span></td><td> a combination of htmlParserOption(s)
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlCtxtReadFd"></a>htmlCtxtReadFd ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> htmlCtxtReadFd (<a href="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt,
+ int fd,
+ const char *URL,
+ const char *encoding,
+ int options);</pre><p>
+parse an XML from a file descriptor and build a tree.
+This reuses the existing <i><tt>ctxt</tt></i> parser context</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> an HTML parser context
+</td></tr><tr><td><span class="term"><i><tt>fd</tt></i>:</span></td><td> an open file descriptor
+</td></tr><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> the base URL to use for the document
+</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding, or NULL
+</td></tr><tr><td><span class="term"><i><tt>options</tt></i>:</span></td><td> a combination of htmlParserOption(s)
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlCtxtReadIO"></a>htmlCtxtReadIO ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> htmlCtxtReadIO (<a href="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt,
+ <a href="libxml-xmlIO.html#xmlInputReadCallback">xmlInputReadCallback</a> ioread,
+ <a href="libxml-xmlIO.html#xmlInputCloseCallback">xmlInputCloseCallback</a> ioclose,
+ void *ioctx,
+ const char *URL,
+ const char *encoding,
+ int options);</pre><p>
+parse an HTML document from I/O functions and source and build a tree.
+This reuses the existing <i><tt>ctxt</tt></i> parser context</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> an HTML parser context
+</td></tr><tr><td><span class="term"><i><tt>ioread</tt></i>:</span></td><td> an I/O read function
+</td></tr><tr><td><span class="term"><i><tt>ioclose</tt></i>:</span></td><td> an I/O close function
+</td></tr><tr><td><span class="term"><i><tt>ioctx</tt></i>:</span></td><td> an I/O handler
+</td></tr><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> the base URL to use for the document
+</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding, or NULL
+</td></tr><tr><td><span class="term"><i><tt>options</tt></i>:</span></td><td> a combination of htmlParserOption(s)
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree
+</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-entities.html"><b>&lt;&lt; entities</b></a></td><td align="right"><a accesskey="n" href="libxml-valid.html"><b>valid &gt;&gt;</b></a></td></tr></table></body></html>
View
207 doc/html/libxml-HTMLtree.html
@@ -28,7 +28,7 @@
.navigation .title {
font-size: 200%;
}
- </style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-list.html" title="list"><link rel="next" href="libxml-parserInternals.html" title="parserInternals"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-list.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-parserInternals.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-HTMLtree"></a><div class="titlepage"></div><div class="refnamediv"><h2>HTMLtree</h2><p>HTMLtree &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2700069"></a>Synopsis</h1></h2><pre class="synopsis">
+ </style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-list.html" title="list"><link rel="next" href="libxml-parserInternals.html" title="parserInternals"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-list.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-parserInternals.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-HTMLtree"></a><div class="titlepage"></div><div class="refnamediv"><h2>HTMLtree</h2><p>HTMLtree &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2610789"></a>Synopsis</h1></h2><pre class="synopsis">
@@ -37,6 +37,55 @@
#define <a href="libxml-HTMLtree.html#HTML-COMMENT-NODE-CAPS">HTML_COMMENT_NODE</a>
#define <a href="libxml-HTMLtree.html#HTML-PRESERVE-NODE-CAPS">HTML_PRESERVE_NODE</a>
#define <a href="libxml-HTMLtree.html#HTML-PI-NODE-CAPS">HTML_PI_NODE</a>
+<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> <a href="libxml-HTMLtree.html#htmlNewDoc">htmlNewDoc</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *URI,
+ const <a href="libxml-tree.html#xmlChar">xmlChar</a> *ExternalID);
+<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> <a href="libxml-HTMLtree.html#htmlNewDocNoDtD">htmlNewDocNoDtD</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *URI,
+ const <a href="libxml-tree.html#xmlChar">xmlChar</a> *ExternalID);
+const <a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-HTMLtree.html#htmlGetMetaEncoding">htmlGetMetaEncoding</a> (<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> doc);
+int <a href="libxml-HTMLtree.html#htmlSetMetaEncoding">htmlSetMetaEncoding</a> (<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> doc,
+ const <a href="libxml-tree.html#xmlChar">xmlChar</a> *encoding);
+void <a href="libxml-HTMLtree.html#htmlDocDumpMemory">htmlDocDumpMemory</a> (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur,
+ <a href="libxml-tree.html#xmlChar">xmlChar</a> **mem,
+ int *size);
+int <a href="libxml-HTMLtree.html#htmlDocDump">htmlDocDump</a> (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *f,
+ <a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur);
+int <a href="libxml-HTMLtree.html#htmlSaveFile">htmlSaveFile</a> (const char *filename,
+ <a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur);
+int <a href="libxml-HTMLtree.html#htmlNodeDump">htmlNodeDump</a> (<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf,
+ <a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
+ <a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur);
+void <a href="libxml-HTMLtree.html#htmlNodeDumpFile">htmlNodeDumpFile</a> (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *out,
+ <a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
+ <a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur);
+int <a href="libxml-HTMLtree.html#htmlNodeDumpFileFormat">htmlNodeDumpFileFormat</a> (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *out,
+ <a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
+ <a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur,
+ const char *encoding,
+ int format);
+int <a href="libxml-HTMLtree.html#htmlSaveFileEnc">htmlSaveFileEnc</a> (const char *filename,
+ <a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur,
+ const char *encoding);
+int <a href="libxml-HTMLtree.html#htmlSaveFileFormat">htmlSaveFileFormat</a> (const char *filename,
+ <a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur,
+ const char *encoding,
+ int format);
+void <a href="libxml-HTMLtree.html#htmlNodeDumpFormatOutput">htmlNodeDumpFormatOutput</a> (<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> buf,
+ <a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
+ <a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur,
+ const char *encoding,
+ int format);
+void <a href="libxml-HTMLtree.html#htmlDocContentDumpOutput">htmlDocContentDumpOutput</a> (<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> buf,
+ <a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur,
+ const char *encoding);
+void <a href="libxml-HTMLtree.html#htmlDocContentDumpFormatOutput">htmlDocContentDumpFormatOutput</a> (<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> buf,
+ <a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur,
+ const char *encoding,
+ int format);
+void <a href="libxml-HTMLtree.html#htmlNodeDumpOutput">htmlNodeDumpOutput</a> (<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> buf,
+ <a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
+ <a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur,
+ const char *encoding);
+int <a href="libxml-HTMLtree.html#htmlIsBooleanAttr">htmlIsBooleanAttr</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="HTML-TEXT-NODE-CAPS"></a>HTML_TEXT_NODE</h3><pre class="programlisting">#define HTML_TEXT_NODE XML_TEXT_NODE
@@ -64,4 +113,158 @@
Macro. A processing instruction in a HTML document is really implemented
the same way as a processing instruction in an XML document.</p><p>
-</p></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-list.html"><b>&lt;&lt; list</b></a></td><td align="right"><a accesskey="n" href="libxml-parserInternals.html"><b>parserInternals &gt;&gt;</b></a></td></tr></table></body></html>
+</p></div><hr><div class="refsect2"><h3><a name="htmlNewDoc"></a>htmlNewDoc ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> htmlNewDoc (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *URI,
+ const <a href="libxml-tree.html#xmlChar">xmlChar</a> *ExternalID);</pre><p>
+Creates a new HTML document</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>URI</tt></i>:</span></td><td> URI for the dtd, or NULL
+</td></tr><tr><td><span class="term"><i><tt>ExternalID</tt></i>:</span></td><td> the external ID of the DTD, or NULL
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a new document
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlNewDocNoDtD"></a>htmlNewDocNoDtD ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> htmlNewDocNoDtD (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *URI,
+ const <a href="libxml-tree.html#xmlChar">xmlChar</a> *ExternalID);</pre><p>
+Creates a new HTML document without a DTD node if <i><tt>URI</tt></i> and <i><tt>ExternalID</tt></i>
+are NULL</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>URI</tt></i>:</span></td><td> URI for the dtd, or NULL
+</td></tr><tr><td><span class="term"><i><tt>ExternalID</tt></i>:</span></td><td> the external ID of the DTD, or NULL
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a new document, do not initialize the DTD if not provided
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlGetMetaEncoding"></a>htmlGetMetaEncoding ()</h3><pre class="programlisting">const <a href="libxml-tree.html#xmlChar">xmlChar</a>* htmlGetMetaEncoding (<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> doc);</pre><p>
+Encoding definition lookup in the Meta tags</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the document
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the current encoding as flagged in the HTML source
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlSetMetaEncoding"></a>htmlSetMetaEncoding ()</h3><pre class="programlisting">int htmlSetMetaEncoding (<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> doc,
+ const <a href="libxml-tree.html#xmlChar">xmlChar</a> *encoding);</pre><p>
+Sets the current encoding in the Meta tags
+NOTE: this will not change the document content encoding, just
+the META flag associated.</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the document
+</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the encoding string
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 in case of success and -1 in case of error
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlDocDumpMemory"></a>htmlDocDumpMemory ()</h3><pre class="programlisting">void htmlDocDumpMemory (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur,
+ <a href="libxml-tree.html#xmlChar">xmlChar</a> **mem,
+ int *size);</pre><p>
+Dump an HTML document in memory and return the xmlChar * and it's size.
+It's up to the caller to free the memory.</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> the document
+</td></tr><tr><td><span class="term"><i><tt>mem</tt></i>:</span></td><td> OUT: the memory pointer
+</td></tr><tr><td><span class="term"><i><tt>size</tt></i>:</span></td><td> OUT: the memory length
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlDocDump"></a>htmlDocDump ()</h3><pre class="programlisting">int htmlDocDump (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *f,
+ <a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur);</pre><p>
+Dump an HTML document to an open FILE.</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>f</tt></i>:</span></td><td> the FILE*
+</td></tr><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> the document
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td> the number of byte written or -1 in case of failure.
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlSaveFile"></a>htmlSaveFile ()</h3><pre class="programlisting">int htmlSaveFile (const char *filename,
+ <a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur);</pre><p>
+Dump an HTML document to a file. If <i><tt>filename</tt></i> is "-" the stdout file is
+used.</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> the filename (or URL)
+</td></tr><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> the document
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td> the number of byte written or -1 in case of failure.
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlNodeDump"></a>htmlNodeDump ()</h3><pre class="programlisting">int htmlNodeDump (<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf,
+ <a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
+ <a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur);</pre><p>
+Dump an HTML node, recursive behaviour,children are printed too,
+and formatting returns are added.</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>buf</tt></i>:</span></td><td> the HTML buffer output
+</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the document
+</td></tr><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> the current node
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number of byte written or -1 in case of error
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlNodeDumpFile"></a>htmlNodeDumpFile ()</h3><pre class="programlisting">void htmlNodeDumpFile (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *out,
+ <a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
+ <a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur);</pre><p>
+Dump an HTML node, recursive behaviour,children are printed too,
+and formatting returns are added.</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>out</tt></i>:</span></td><td> the FILE pointer
+</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the document
+</td></tr><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> the current node
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlNodeDumpFileFormat"></a>htmlNodeDumpFileFormat ()</h3><pre class="programlisting">int htmlNodeDumpFileFormat (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *out,
+ <a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
+ <a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur,
+ const char *encoding,
+ int format);</pre><p>
+Dump an HTML node, recursive behaviour,children are printed too.
+</p><p>
+TODO: if encoding == NULL try to save in the doc encoding</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>out</tt></i>:</span></td><td> the FILE pointer
+</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the document
+</td></tr><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> the current node
+</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding
+</td></tr><tr><td><span class="term"><i><tt>format</tt></i>:</span></td><td> should formatting spaces been added
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td> the number of byte written or -1 in case of failure.
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlSaveFileEnc"></a>htmlSaveFileEnc ()</h3><pre class="programlisting">int htmlSaveFileEnc (const char *filename,
+ <a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur,
+ const char *encoding);</pre><p>
+Dump an HTML document to a file using a given encoding
+and formatting returns/spaces are added.</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> the filename
+</td></tr><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> the document
+</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td> the number of byte written or -1 in case of failure.
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlSaveFileFormat"></a>htmlSaveFileFormat ()</h3><pre class="programlisting">int htmlSaveFileFormat (const char *filename,
+ <a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur,
+ const char *encoding,
+ int format);</pre><p>
+Dump an HTML document to a file using a given encoding.</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> the filename
+</td></tr><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> the document
+</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding
+</td></tr><tr><td><span class="term"><i><tt>format</tt></i>:</span></td><td> should formatting spaces been added
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td> the number of byte written or -1 in case of failure.
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlNodeDumpFormatOutput"></a>htmlNodeDumpFormatOutput ()</h3><pre class="programlisting">void htmlNodeDumpFormatOutput (<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> buf,
+ <a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
+ <a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur,
+ const char *encoding,
+ int format);</pre><p>
+Dump an HTML node, recursive behaviour,children are printed too.</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>buf</tt></i>:</span></td><td> the HTML buffer output
+</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the document
+</td></tr><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> the current node
+</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the encoding string
+</td></tr><tr><td><span class="term"><i><tt>format</tt></i>:</span></td><td> should formatting spaces been added
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlDocContentDumpOutput"></a>htmlDocContentDumpOutput ()</h3><pre class="programlisting">void htmlDocContentDumpOutput (<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> buf,
+ <a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur,
+ const char *encoding);</pre><p>
+Dump an HTML document. Formating return/spaces are added.</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>buf</tt></i>:</span></td><td> the HTML buffer output
+</td></tr><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> the document
+</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the encoding string
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlDocContentDumpFormatOutput"></a>htmlDocContentDumpFormatOutput ()</h3><pre class="programlisting">void htmlDocContentDumpFormatOutput (<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> buf,
+ <a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur,
+ const char *encoding,
+ int format);</pre><p>
+Dump an HTML document.</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>buf</tt></i>:</span></td><td> the HTML buffer output
+</td></tr><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> the document
+</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the encoding string
+</td></tr><tr><td><span class="term"><i><tt>format</tt></i>:</span></td><td> should formatting spaces been added
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlNodeDumpOutput"></a>htmlNodeDumpOutput ()</h3><pre class="programlisting">void htmlNodeDumpOutput (<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> buf,
+ <a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
+ <a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur,
+ const char *encoding);</pre><p>
+Dump an HTML node, recursive behaviour,children are printed too,
+and formatting returns/spaces are added.</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>buf</tt></i>:</span></td><td> the HTML buffer output
+</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the document
+</td></tr><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> the current node
+</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the encoding string
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlIsBooleanAttr"></a>htmlIsBooleanAttr ()</h3><pre class="programlisting">int htmlIsBooleanAttr (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
+Determine if a given attribute is a boolean attribute.</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the name of the attribute to check
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td> false if the attribute is not boolean, true otherwise.
+</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-list.html"><b>&lt;&lt; list</b></a></td><td align="right"><a accesskey="n" href="libxml-parserInternals.html"><b>parserInternals &gt;&gt;</b></a></td></tr></table></body></html>
View
428 doc/html/libxml-SAX.html
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>SAX</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>SAX</title><meta name="generator" content="DocBook XSL Stylesheets V1.48"><meta name="generator" content="GTK-Doc V1.1 (XML mode)"><style type="text/css">
.synopsis, .classsynopsis {
background: #eeeeee;
border: solid 1px #aaaaaa;
@@ -28,7 +28,7 @@
.navigation .title {
font-size: 200%;
}
- </style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="libxml-lib.html" title="Libxml Library Reference"><link rel="previous" href="libxml-xmlreader.html" title="xmlreader"><link rel="next" href="libxml-tree.html" title="tree"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table xmlns="http://www.w3.org/TR/xhtml1/transitional" class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xmlreader.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></img></a></td><td><a accesskey="u" href="libxml-lib.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></img></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></img></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-tree.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></img></a></td></tr></table><div class="refentry" lang="en"><a name="libxml-SAX"></a><div class="titlepage"></div><div class="refnamediv"><h2>SAX</h2><p>SAX &#8212; </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="synopsis">
+ </style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-xpath.html" title="xpath"><link rel="next" href="libxml-chvalid.html" title="chvalid"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xpath.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-chvalid.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-SAX"></a><div class="titlepage"></div><div class="refnamediv"><h2>SAX</h2><p>SAX &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2583364"></a>Synopsis</h1></h2><pre class="synopsis">
@@ -119,301 +119,305 @@
void <a href="libxml-SAX.html#cdataBlock">cdataBlock</a> (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value,
int len);
-void <a href="libxml-SAX.html#initxmlDefaultSAXHandler">initxmlDefaultSAXHandler</a> (<a href="libxml-parser.html#xmlSAXHandler">xmlSAXHandler</a> *hdlr,
+void <a href="libxml-SAX.html#initxmlDefaultSAXHandler">initxmlDefaultSAXHandler</a> (<a href="libxml-parser.html#xmlSAXHandlerV1">xmlSAXHandlerV1</a> *hdlr,
int warning);
-void <a href="libxml-SAX.html#inithtmlDefaultSAXHandler">inithtmlDefaultSAXHandler</a> (<a href="libxml-parser.html#xmlSAXHandler">xmlSAXHandler</a> *hdlr);
-void <a href="libxml-SAX.html#initdocbDefaultSAXHandler">initdocbDefaultSAXHandler</a> (<a href="libxml-parser.html#xmlSAXHandler">xmlSAXHandler</a> *hdlr);
-void <a href="libxml-SAX.html#xmlDefaultSAXHandlerInit">xmlDefaultSAXHandlerInit</a> (void);
-void <a href="libxml-SAX.html#htmlDefaultSAXHandlerInit">htmlDefaultSAXHandlerInit</a> (void);
-void <a href="libxml-SAX.html#docbDefaultSAXHandlerInit">docbDefaultSAXHandlerInit</a> (void);
-</pre></div><div class="refsect1" lang="en"><h2>Description</h2><p>
-
-</p></div><div class="refsect1" lang="en"><h2>Details</h2><div class="refsect2" lang="en"><h3><a name="getPublicId"></a>getPublicId ()</h3><pre class="programlisting">const <a href="libxml-tree.html#xmlChar">xmlChar</a>* getPublicId (void *ctx);</pre><p>
-Provides the public ID e.g. "-//SGMLSOURCE//DTD DEMO//EN"</p><p>
-
-</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
-</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>a xmlChar *
-</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="getSystemId"></a>getSystemId ()</h3><pre class="programlisting">const <a href="libxml-tree.html#xmlChar">xmlChar</a>* getSystemId (void *ctx);</pre><p>
+void <a href="libxml-SAX.html#inithtmlDefaultSAXHandler">inithtmlDefaultSAXHandler</a> (<a href="libxml-parser.html#xmlSAXHandlerV1">xmlSAXHandlerV1</a> *hdlr);
+void <a href="libxml-SAX.html#initdocbDefaultSAXHandler">initdocbDefaultSAXHandler</a> (<a href="libxml-parser.html#xmlSAXHandlerV1">xmlSAXHandlerV1</a> *hdlr);
+</pre></div><div class="refsect1"><h2>Description</h2><p>
+
+</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="getPublicId"></a>getPublicId ()</h3><pre class="programlisting">const <a href="libxml-tree.html#xmlChar">xmlChar</a>* getPublicId (void *ctx);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>getPublicId</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2GetPublicId">xmlSAX2GetPublicId</a>()</p></div><p>
+Provides the public ID e.g. "-//SGMLSOURCE//DTD DEMO//EN"
+Returns</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a xmlChar *
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="getSystemId"></a>getSystemId ()</h3><pre class="programlisting">const <a href="libxml-tree.html#xmlChar">xmlChar</a>* getSystemId (void *ctx);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>getSystemId</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2GetSystemId">xmlSAX2GetSystemId</a>()</p></div><p>
Provides the system ID, basically URL or filename e.g.
-http://www.sgmlsource.com/dtds/memo.dtd</p><p>
+http://www.sgmlsource.com/dtds/memo.dtd
+Returns</p><p>
-</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
-</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>a xmlChar *
-</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="setDocumentLocator"></a>setDocumentLocator ()</h3><pre class="programlisting">void setDocumentLocator (void *ctx,
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a xmlChar *
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="setDocumentLocator"></a>setDocumentLocator ()</h3><pre class="programlisting">void setDocumentLocator (void *ctx,
<a href="libxml-tree.html#xmlSAXLocatorPtr">xmlSAXLocatorPtr</a> loc);</pre><p>
Receive the document locator at startup, actually xmlDefaultSAXLocator
-Everything is available on the context, so this is useless in our case.</p><p>
-
-</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
-</td></tr><tr><td><span class="term"><i><tt>loc</tt></i> :</span></td><td> A SAX Locator
-</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="getLineNumber"></a>getLineNumber ()</h3><pre class="programlisting">int getLineNumber (void *ctx);</pre><p>
-Provide the line number of the current parsing point.</p><p>
-
-</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
-</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>an int
-</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="getColumnNumber"></a>getColumnNumber ()</h3><pre class="programlisting">int getColumnNumber (void *ctx);</pre><p>
-Provide the column number of the current parsing point.</p><p>
-
-</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
-</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>an int
-</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="isStandalone"></a>isStandalone ()</h3><pre class="programlisting">int isStandalone (void *ctx);</pre><p>
-Is this document tagged standalone ?</p><p>
-
-</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
-</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>1 if true
-</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="hasInternalSubset"></a>hasInternalSubset ()</h3><pre class="programlisting">int hasInternalSubset (void *ctx);</pre><p>
-Does this document has an internal subset</p><p>
-
-</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
-</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>1 if true
-</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="hasExternalSubset"></a>hasExternalSubset ()</h3><pre class="programlisting">int hasExternalSubset (void *ctx);</pre><p>
-Does this document has an external subset</p><p>
-
-</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
-</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>1 if true
-</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="internalSubset"></a>internalSubset ()</h3><pre class="programlisting">void internalSubset (void *ctx,
+Everything is available on the context, so this is useless in our case.
+DEPRECATED</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
+</td></tr><tr><td><span class="term"><i><tt>loc</tt></i>:</span></td><td> A SAX Locator
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="getLineNumber"></a>getLineNumber ()</h3><pre class="programlisting">int getLineNumber (void *ctx);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>getLineNumber</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2GetLineNumber">xmlSAX2GetLineNumber</a>()</p></div><p>
+Provide the line number of the current parsing point.
+Returns</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>an int
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="getColumnNumber"></a>getColumnNumber ()</h3><pre class="programlisting">int getColumnNumber (void *ctx);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>getColumnNumber</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2GetColumnNumber">xmlSAX2GetColumnNumber</a>()</p></div><p>
+Provide the column number of the current parsing point.
+Returns</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>an int
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="isStandalone"></a>isStandalone ()</h3><pre class="programlisting">int isStandalone (void *ctx);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>isStandalone</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2IsStandalone">xmlSAX2IsStandalone</a>()</p></div><p>
+Is this document tagged standalone ?
+Returns</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if true
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="hasInternalSubset"></a>hasInternalSubset ()</h3><pre class="programlisting">int hasInternalSubset (void *ctx);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>hasInternalSubset</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2HasInternalSubset">xmlSAX2HasInternalSubset</a>()</p></div><p>
+Does this document has an internal subset
+Returns</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if true
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="hasExternalSubset"></a>hasExternalSubset ()</h3><pre class="programlisting">int hasExternalSubset (void *ctx);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>hasExternalSubset</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2HasExternalSubset">xmlSAX2HasExternalSubset</a>()</p></div><p>
+Does this document has an external subset
+Returns</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if true
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="internalSubset"></a>internalSubset ()</h3><pre class="programlisting">void internalSubset (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *ExternalID,
- const <a href="libxml-tree.html#xmlChar">xmlChar</a> *SystemID);</pre><p>
+ const <a href="libxml-tree.html#xmlChar">xmlChar</a> *SystemID);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>internalSubset</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2InternalSubset">xmlSAX2InternalSubset</a>()</p></div><p>
Callback on internal subset declaration.</p><p>
-</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
-</td></tr><tr><td><span class="term"><i><tt>name</tt></i> :</span></td><td> the root element name
-</td></tr><tr><td><span class="term"><i><tt>ExternalID</tt></i> :</span></td><td> the external ID
-</td></tr><tr><td><span class="term"><i><tt>SystemID</tt></i> :</span></td><td> the SYSTEM ID (e.g. filename or URL)
-</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="externalSubset"></a>externalSubset ()</h3><pre class="programlisting">void externalSubset (void *ctx,
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
+</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the root element name
+</td></tr><tr><td><span class="term"><i><tt>ExternalID</tt></i>:</span></td><td> the external ID
+</td></tr><tr><td><span class="term"><i><tt>SystemID</tt></i>:</span></td><td> the SYSTEM ID (e.g. filename or URL)
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="externalSubset"></a>externalSubset ()</h3><pre class="programlisting">void externalSubset (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *ExternalID,
- const <a href="libxml-tree.html#xmlChar">xmlChar</a> *SystemID);</pre><p>
+ const <a href="libxml-tree.html#xmlChar">xmlChar</a> *SystemID);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>externalSubset</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2ExternalSubset">xmlSAX2ExternalSubset</a>()</p></div><p>
Callback on external subset declaration.</p><p>
-</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
-</td></tr><tr><td><span class="term"><i><tt>name</tt></i> :</span></td><td> the root element name
-</td></tr><tr><td><span class="term"><i><tt>ExternalID</tt></i> :</span></td><td> the external ID
-</td></tr><tr><td><span class="term"><i><tt>SystemID</tt></i> :</span></td><td> the SYSTEM ID (e.g. filename or URL)
-</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="getEntity"></a>getEntity ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> getEntity (void *ctx,
- const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
-Get an entity by name</p><p>
-
-</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
-</td></tr><tr><td><span class="term"><i><tt>name</tt></i> :</span></td><td> The entity name
-</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>the xmlEntityPtr if found.
-</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="getParameterEntity"></a>getParameterEntity ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> getParameterEntity (void *ctx,
- const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
-Get a parameter entity by name</p><p>
-
-</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
-</td></tr><tr><td><span class="term"><i><tt>name</tt></i> :</span></td><td> The entity name
-</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>the xmlEntityPtr if found.
-</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="resolveEntity"></a>resolveEntity ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlParserInputPtr">xmlParserInputPtr</a> resolveEntity (void *ctx,
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
+</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the root element name
+</td></tr><tr><td><span class="term"><i><tt>ExternalID</tt></i>:</span></td><td> the external ID
+</td></tr><tr><td><span class="term"><i><tt>SystemID</tt></i>:</span></td><td> the SYSTEM ID (e.g. filename or URL)
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="getEntity"></a>getEntity ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> getEntity (void *ctx,
+ const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>getEntity</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2GetEntity">xmlSAX2GetEntity</a>()</p></div><p>
+Get an entity by name
+Returns</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
+</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> The entity name
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the xmlEntityPtr if found.
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="getParameterEntity"></a>getParameterEntity ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> getParameterEntity (void *ctx,
+ const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>getParameterEntity</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2GetParameterEntity">xmlSAX2GetParameterEntity</a>()</p></div><p>
+Get a parameter entity by name
+Returns</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
+</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> The entity name
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the xmlEntityPtr if found.
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="resolveEntity"></a>resolveEntity ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlParserInputPtr">xmlParserInputPtr</a> resolveEntity (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *publicId,
- const <a href="libxml-tree.html#xmlChar">xmlChar</a> *systemId);</pre><p>
+ const <a href="libxml-tree.html#xmlChar">xmlChar</a> *systemId);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>resolveEntity</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2ResolveEntity">xmlSAX2ResolveEntity</a>()</p></div><p>
The entity loader, to control the loading of external entities,
the application can either:
- override this <a href="libxml-SAX.html#resolveEntity">resolveEntity</a>() callback in the SAX block
- or better use the <a href="libxml-parser.html#xmlSetExternalEntityLoader">xmlSetExternalEntityLoader</a>() function to
- set up it's own entity resolution routine</p><p>
-
-</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
-</td></tr><tr><td><span class="term"><i><tt>publicId</tt></i> :</span></td><td> The public ID of the entity
-</td></tr><tr><td><span class="term"><i><tt>systemId</tt></i> :</span></td><td> The system ID of the entity
-</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>the xmlParserInputPtr if inlined or NULL for DOM behaviour.
-</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="entityDecl"></a>entityDecl ()</h3><pre class="programlisting">void entityDecl (void *ctx,
+ set up it's own entity resolution routine
+Returns</p><p>
+
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
+</td></tr><tr><td><span class="term"><i><tt>publicId</tt></i>:</span></td><td> The public ID of the entity
+</td></tr><tr><td><span class="term"><i><tt>systemId</tt></i>:</span></td><td> The system ID of the entity
+</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the xmlParserInputPtr if inlined or NULL for DOM behaviour.
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="entityDecl"></a>entityDecl ()</h3><pre class="programlisting">void entityDecl (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
int type,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *publicId,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *systemId,
- <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);</pre><p>
+ <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>entityDecl</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2EntityDecl">xmlSAX2EntityDecl</a>()</p></div><p>
An entity definition has been parsed</p><p>
-</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
-</td></tr><tr><td><span class="term"><i><tt>name</tt></i> :</span></td><td> the entity name
-</td></tr><tr><td><span class="term"><i><tt>type</tt></i> :</span></td><td> the entity type
-</td></tr><tr><td><span class="term"><i><tt>publicId</tt></i> :</span></td><td> The public ID of the entity
-</td></tr><tr><td><span class="term"><i><tt>systemId</tt></i> :</span></td><td> The system ID of the entity
-</td></tr><tr><td><span class="term"><i><tt>content</tt></i> :</span></td><td> the entity value (without processing).
-</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="attributeDecl"></a>attributeDecl ()</h3><pre class="programlisting">void attributeDecl (void *ctx,
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
+</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the entity name
+</td></tr><tr><td><span class="term"><i><tt>type</tt></i>:</span></td><td> the entity type
+</td></tr><tr><td><span class="term"><i><tt>publicId</tt></i>:</span></td><td> The public ID of the entity
+</td></tr><tr><td><span class="term"><i><tt>systemId</tt></i>:</span></td><td> The system ID of the entity
+</td></tr><tr><td><span class="term"><i><tt>content</tt></i>:</span></td><td> the entity value (without processing).
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="attributeDecl"></a>attributeDecl ()</h3><pre class="programlisting">void attributeDecl (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *elem,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *fullname,
int type,
int def,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *defaultValue,
- <a href="libxml-tree.html#xmlEnumerationPtr">xmlEnumerationPtr</a> tree);</pre><p>
+ <a href="libxml-tree.html#xmlEnumerationPtr">xmlEnumerationPtr</a> tree);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>attributeDecl</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2AttributeDecl">xmlSAX2AttributeDecl</a>()</p></div><p>
An attribute definition has been parsed</p><p>
-</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
-</td></tr><tr><td><span class="term"><i><tt>elem</tt></i> :</span></td><td> the name of the element
-</td></tr><tr><td><span class="term"><i><tt>fullname</tt></i> :</span></td><td> the attribute name
-</td></tr><tr><td><span class="term"><i><tt>type</tt></i> :</span></td><td> the attribute type
-</td></tr><tr><td><span class="term"><i><tt>def</tt></i> :</span></td><td> the type of default value
-</td></tr><tr><td><span class="term"><i><tt>defaultValue</tt></i> :</span></td><td> the attribute default value
-</td></tr><tr><td><span class="term"><i><tt>tree</tt></i> :</span></td><td> the tree of enumerated value set
-</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="elementDecl"></a>elementDecl ()</h3><pre class="programlisting">void elementDecl (void *ctx,
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
+</td></tr><tr><td><span class="term"><i><tt>elem</tt></i>:</span></td><td> the name of the element
+</td></tr><tr><td><span class="term"><i><tt>fullname</tt></i>:</span></td><td> the attribute name
+</td></tr><tr><td><span class="term"><i><tt>type</tt></i>:</span></td><td> the attribute type
+</td></tr><tr><td><span class="term"><i><tt>def</tt></i>:</span></td><td> the type of default value
+</td></tr><tr><td><span class="term"><i><tt>defaultValue</tt></i>:</span></td><td> the attribute default value
+</td></tr><tr><td><span class="term"><i><tt>tree</tt></i>:</span></td><td> the tree of enumerated value set
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="elementDecl"></a>elementDecl ()</h3><pre class="programlisting">void elementDecl (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
int type,
- <a href="libxml-tree.html#xmlElementContentPtr">xmlElementContentPtr</a> content);</pre><p>
+ <a href="libxml-tree.html#xmlElementContentPtr">xmlElementContentPtr</a> content);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>elementDecl</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2ElementDecl">xmlSAX2ElementDecl</a>()</p></div><p>
An element definition has been parsed</p><p>
-</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
-</td></tr><tr><td><span class="term"><i><tt>name</tt></i> :</span></td><td> the element name
-</td></tr><tr><td><span class="term"><i><tt>type</tt></i> :</span></td><td> the element type
-</td></tr><tr><td><span class="term"><i><tt>content</tt></i> :</span></td><td> the element value tree
-</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="notationDecl"></a>notationDecl ()</h3><pre class="programlisting">void notationDecl (void *ctx,
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
+</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the element name
+</td></tr><tr><td><span class="term"><i><tt>type</tt></i>:</span></td><td> the element type
+</td></tr><tr><td><span class="term"><i><tt>content</tt></i>:</span></td><td> the element value tree
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="notationDecl"></a>notationDecl ()</h3><pre class="programlisting">void notationDecl (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *publicId,
- const <a href="libxml-tree.html#xmlChar">xmlChar</a> *systemId);</pre><p>
+ const <a href="libxml-tree.html#xmlChar">xmlChar</a> *systemId);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>notationDecl</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2NotationDecl">xmlSAX2NotationDecl</a>()</p></div><p>
What to do when a notation declaration has been parsed.</p><p>
-</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
-</td></tr><tr><td><span class="term"><i><tt>name</tt></i> :</span></td><td> The name of the notation
-</td></tr><tr><td><span class="term"><i><tt>publicId</tt></i> :</span></td><td> The public ID of the entity
-</td></tr><tr><td><span class="term"><i><tt>systemId</tt></i> :</span></td><td> The system ID of the entity
-</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="unparsedEntityDecl"></a>unparsedEntityDecl ()</h3><pre class="programlisting">void unparsedEntityDecl (void *ctx,
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
+</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> The name of the notation
+</td></tr><tr><td><span class="term"><i><tt>publicId</tt></i>:</span></td><td> The public ID of the entity
+</td></tr><tr><td><span class="term"><i><tt>systemId</tt></i>:</span></td><td> The system ID of the entity
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="unparsedEntityDecl"></a>unparsedEntityDecl ()</h3><pre class="programlisting">void unparsedEntityDecl (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *publicId,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *systemId,
- const <a href="libxml-tree.html#xmlChar">xmlChar</a> *notationName);</pre><p>
+ const <a href="libxml-tree.html#xmlChar">xmlChar</a> *notationName);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>unparsedEntityDecl</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2UnparsedEntityDecl">xmlSAX2UnparsedEntityDecl</a>()</p></div><p>
What to do when an unparsed entity declaration is parsed</p><p>
-</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
-</td></tr><tr><td><span class="term"><i><tt>name</tt></i> :</span></td><td> The name of the entity
-</td></tr><tr><td><span class="term"><i><tt>publicId</tt></i> :</span></td><td> The public ID of the entity
-</td></tr><tr><td><span class="term"><i><tt>systemId</tt></i> :</span></td><td> The system ID of the entity
-</td></tr><tr><td><span class="term"><i><tt>notationName</tt></i> :</span></td><td> the name of the notation
-</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="startDocument"></a>startDocument ()</h3><pre class="programlisting">void startDocument (void *ctx);</pre><p>
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
+</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> The name of the entity
+</td></tr><tr><td><span class="term"><i><tt>publicId</tt></i>:</span></td><td> The public ID of the entity
+</td></tr><tr><td><span class="term"><i><tt>systemId</tt></i>:</span></td><td> The system ID of the entity
+</td></tr><tr><td><span class="term"><i><tt>notationName</tt></i>:</span></td><td> the name of the notation
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="startDocument"></a>startDocument ()</h3><pre class="programlisting">void startDocument (void *ctx);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>startDocument</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2StartDocument">xmlSAX2StartDocument</a>()</p></div><p>
called when the document start being processed.</p><p>
-</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
-</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="endDocument"></a>endDocument ()</h3><pre class="programlisting">void endDocument (void *ctx);</pre><p>
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="endDocument"></a>endDocument ()</h3><pre class="programlisting">void endDocument (void *ctx);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>endDocument</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2EndDocument">xmlSAX2EndDocument</a>()</p></div><p>
called when the document end has been detected.</p><p>
-</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
-</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="attribute"></a>attribute ()</h3><pre class="programlisting">void attribute (void *ctx,
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="attribute"></a>attribute ()</h3><pre class="programlisting">void attribute (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *fullname,
- const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value);</pre><p>
+ const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>attribute</tt> is deprecated and should not be used in newly-written code. use <GTKDOCLINK HREF="xmlSAX2Attribute">xmlSAX2Attribute</GTKDOCLINK>()</p></div><p>
Handle an attribute that has been read by the parser.
The default handling is to convert the attribute into an
DOM subtree and past it in a new xmlAttr element added to
the element.</p><p>
-</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
-</td></tr><tr><td><span class="term"><i><tt>fullname</tt></i> :</span></td><td> The attribute name, including namespace prefix
-</td></tr><tr><td><span class="term"><i><tt>value</tt></i> :</span></td><td> The attribute value
-</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="startElement"></a>startElement ()</h3><pre class="programlisting">void startElement (void *ctx,
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
+</td></tr><tr><td><span class="term"><i><tt>fullname</tt></i>:</span></td><td> The attribute name, including namespace prefix
+</td></tr><tr><td><span class="term"><i><tt>value</tt></i>:</span></td><td> The attribute value
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="startElement"></a>startElement ()</h3><pre class="programlisting">void startElement (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *fullname,
- const <a href="libxml-tree.html#xmlChar">xmlChar</a> **atts);</pre><p>
+ const <a href="libxml-tree.html#xmlChar">xmlChar</a> **atts);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>startElement</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2StartElement">xmlSAX2StartElement</a>()</p></div><p>
called when an opening tag has been processed.</p><p>
-</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
-</td></tr><tr><td><span class="term"><i><tt>fullname</tt></i> :</span></td><td> The element name, including namespace prefix
-</td></tr><tr><td><span class="term"><i><tt>atts</tt></i> :</span></td><td> An array of name/value attributes pairs, NULL terminated
-</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="endElement"></a>endElement ()</h3><pre class="programlisting">void endElement (void *ctx,
- const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
+</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
+</td></tr><tr><td><span class="term"><i><tt>fullname</tt></i>:</span></td><td> The element name, including namespace prefix
+</td></tr><tr><td><span class="term"><i><tt>atts</tt></i>:</span></td><td> An array of name/value attributes pairs, NULL terminated
+</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="endElement"></a>endElement ()</h3><pre class="programlisting">void endElement (void *ctx,
+ const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><div class="warning" style="mar