1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/docs/COPYING.txt Sun Jan 18 23:04:41 2004 +0000
1.3 @@ -0,0 +1,23 @@
1.4 + Copyright (C) 2003, 2004 Paul Boddie <paul@boddie.org.uk>.
1.5 + All Rights Reserved.
1.6 +
1.7 +Permission is hereby granted, free of charge, to any person obtaining a copy
1.8 +of this software and associated documentation files (the "Software"), to deal
1.9 +in the Software without restriction, including without limitation the rights
1.10 +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
1.11 +copies of the Software, and to permit persons to whom the Software is
1.12 +furnished to do so, subject to the following conditions:
1.13 +
1.14 +The above copyright notice and this permission notice shall be included in
1.15 +all copies or substantial portions of the Software.
1.16 +
1.17 +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
1.18 +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
1.19 +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL PAUL
1.20 +BODDIE BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
1.21 +ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
1.22 +WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
1.23 +
1.24 +Except as contained in this notice, the name of Paul Boddie shall not be used
1.25 +in advertising or otherwise to promote the sale, use or other dealings in
1.26 +this Software without prior written authorization from him.
2.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
2.2 +++ b/docs/index.html Sun Jan 18 23:04:41 2004 +0000
2.3 @@ -0,0 +1,64 @@
2.4 +<?xml version="1.0" encoding="iso-8859-1"?>
2.5 +<html xmlns="http://www.w3.org/1999/xhtml">
2.6 +<head>
2.7 + <title>XMLTools2</title>
2.8 + <meta name="generator" content="amaya 8.1a, see http://www.w3.org/Amaya/" />
2.9 + <link href="styles.css" rel="stylesheet" type="text/css" />
2.10 +</head>
2.11 +
2.12 +<body>
2.13 +<h1>libxml2dom</h1>
2.14 +
2.15 +<p>The libxml2dom package provides a traditional DOM wrapper around the
2.16 +Python bindings for libxml2. In contrast to the libxml2 bindings, libxml2dom
2.17 +provides an API reminiscent of minidom, pxdom and other Python-based and
2.18 +Python-related XML toolkits. Performance is disappointing, given the typical
2.19 +high speed of libxml2 processing, but this is to be expected since large
2.20 +numbers of Python objects are instantiated at two levels of document tree
2.21 +representation. However, serialisation of documents is much faster than many
2.22 +other toolkits because it can make direct use of libxml2.</p>
2.23 +
2.24 +<h2>Copyright and Licence</h2>
2.25 +
2.26 +<p>For reasons of consistency, libxml2dom uses the same MIT-style licence as
2.27 +libxml2. See the file <code>COPYING.txt</code> in the <code>docs</code>
2.28 +directory within the source code distribution.</p>
2.29 +
2.30 +<h2>Dependencies and Installation Issues</h2>
2.31 +
2.32 +<p>The following descriptions identify dependencies and describe appropriate
2.33 +installation issues with each dependency:</p>
2.34 +
2.35 +<h3>libxml2 2.6.0</h3>
2.36 +
2.37 +<p>Building libxml2 from source and configuring the Python bindings can be
2.38 +done as follows:</p>
2.39 +<pre>cd libxml2-2.6.0
2.40 +./configure --with-python=/usr/local/bin/python
2.41 +make</pre>
2.42 +
2.43 +<p>If you are to use an installation of Python installed outside
2.44 +<code>/usr/local</code> then specify the "prefix" accordingly. Install
2.45 +(possibly as <code>root</code>) in the usual way:</p>
2.46 +<pre>make install</pre>
2.47 +
2.48 +<h4>Issues</h4>
2.49 +
2.50 +<p>The <code>patches</code> directory in the source code distribution
2.51 +contains a patch against libxml2 2.5.7 which resolves an issue exposed by
2.52 +libxml2dom. Although it is recommended that later releases of libxml2 are
2.53 +used instead, the source code distribution of libxml2 2.5.7 can be patched as
2.54 +follows:</p>
2.55 +<pre>patch -p0 < libxml2dom/patches/libxml2/libxml.c.diff</pre>
2.56 +
2.57 +<p>The command should be run outside/above the <code>libxml2-2.5.7</code>
2.58 +directory, and the stated path should be adjusted accordingly.</p>
2.59 +
2.60 +<h3>Python 2.2</h3>
2.61 +
2.62 +<p>Python releases from 2.2 onwards should be compatible with libxml2dom. The
2.63 +principal requirement from such releases is the new-style class support which
2.64 +permits the use of properties in the libxml2dom implementation, thus
2.65 +simplifying the code somewhat.</p>
2.66 +</body>
2.67 +</html>