1 <?xml version="1.0" encoding="iso-8859-1"?> 2 <html xmlns="http://www.w3.org/1999/xhtml"> 3 <head> 4 <title>libxml2dom</title> 5 <meta name="generator" content="amaya 8.1a, see http://www.w3.org/Amaya/" /> 6 <link href="styles.css" rel="stylesheet" type="text/css" /> 7 </head> 8 9 <body> 10 <h1>libxml2dom</h1> 11 12 <p>The libxml2dom package provides a traditional DOM wrapper around the 13 Python bindings for libxml2. In contrast to the libxml2 bindings, libxml2dom 14 provides an API reminiscent of minidom, pxdom and other Python-based and 15 Python-related XML toolkits. Performance is disappointing, given the typical 16 high speed of libxml2 processing, but this is to be expected since large 17 numbers of Python objects are instantiated at two levels of document tree 18 representation. However, serialisation of documents is much faster than many 19 other toolkits because it can make direct use of libxml2.</p> 20 21 <h2>Copyright and Licence</h2> 22 23 <p>For reasons of consistency, libxml2dom uses the same MIT-style licence as 24 libxml2. See the file <code>COPYING.txt</code> in the <code>docs</code> 25 directory within the source code distribution.</p> 26 27 <h2>Dependencies and Installation Issues</h2> 28 29 <p>The following descriptions identify dependencies and describe appropriate 30 installation issues with each dependency:</p> 31 32 <h3>libxml2 2.6.0</h3> 33 34 <p>Building libxml2 from source and configuring the Python bindings can be 35 done as follows:</p> 36 <pre>cd libxml2-2.6.0 37 ./configure --with-python=/usr/local/bin/python 38 make</pre> 39 40 <p>If you are to use an installation of Python installed outside 41 <code>/usr/local</code> then specify the "prefix" accordingly. Install 42 (possibly as <code>root</code>) in the usual way:</p> 43 <pre>make install</pre> 44 45 <h4>Issues</h4> 46 47 <p>The <code>patches</code> directory in the source code distribution 48 contains a patch against libxml2 2.5.7 which resolves an issue exposed by 49 libxml2dom. Although it is recommended that later releases of libxml2 are 50 used instead, the source code distribution of libxml2 2.5.7 can be patched as 51 follows:</p> 52 <pre>patch -p0 < libxml2dom/patches/libxml2/libxml.c.diff</pre> 53 54 <p>The command should be run outside/above the <code>libxml2-2.5.7</code> 55 directory, and the stated path should be adjusted accordingly.</p> 56 57 <h3>Python 2.2</h3> 58 59 <p>Python releases from 2.2 onwards should be compatible with libxml2dom. The 60 principal requirement from such releases is the new-style class support which 61 permits the use of properties in the libxml2dom implementation, thus 62 simplifying the code somewhat.</p> 63 64 <h2>Changelog</h2> 65 66 <h3>New in libxml2dom 0.1.1 (Changes since libxml2dom 0.1)</h3> 67 <ul> 68 <li>Fixed text node creation.</li> 69 <li>Fixed setAttributeNS.</li> 70 <li>Added encoding parameters to convenience methods.</li> 71 <li>Added the missing previousSibling property.</li> 72 <li>Added release number to the package.</li> 73 </ul> 74 </body> 75 </html>