| 1 |
Perl module: XML-DOM |
| 2 |
|
| 3 |
Copyright (c) 1999,2000 Enno Derksen |
| 4 |
All rights reserved. |
| 5 |
This program is free software; you can redistribute it and/or modify it |
| 6 |
under the same terms as Perl itself. |
| 7 |
|
| 8 |
The XML::DOM code is fairly stable and has been used quite a bit. |
| 9 |
|
| 10 |
However, there is a new DOM module, XML::GDOME which is under active |
| 11 |
development and significantly faster than XML::DOM, since it is based on |
| 12 |
the libgdome C library. It provides Level 2 of the DOM Core API. For |
| 13 |
more details see http://tjmather.com/xml-gdome/ |
| 14 |
|
| 15 |
Patches welcome! Send them to [email protected] |
| 16 |
|
| 17 |
Paid support is available from directly from the maintainers of this package. |
| 18 |
Please see http://www.maxmind.com/app/opensourceservices for more details. |
| 19 |
|
| 20 |
========= DEPENDENCIES ========================================================= |
| 21 |
|
| 22 |
You need the following modules (all available at CPAN): |
| 23 |
|
| 24 |
- Perl 5.6.0 or higher (can run under earlier versions, simply remove |
| 25 |
use bytes; |
| 26 |
from lib/XML/DOM.pm) |
| 27 |
- XML::RegExp |
| 28 |
- XML::Parser (At least version 2.28, 2.30 recommended) |
| 29 |
If you are using XML::Parser 2.27, then you should download |
| 30 |
libxml-enno-1.02 from your local CPAN mirror. |
| 31 |
If you are using Perl 5.8.0 or greater and XML::Parser 2.32 or lesser, you must apply the |
| 32 |
included XML-Parser-2.31.patch. |
| 33 |
- LWP::UserAgent (It's part of libwww-perl. If you don't have it, some test |
| 34 |
cases may fail and you can't read files from URLs.) |
| 35 |
- XML::Parser::PerlSAX (It's part of libxml-perl. You need at least version 0.06. |
| 36 |
If you don't have it some test cases may fail.) |
| 37 |
|
| 38 |
========= INSTALLATION ========================================================= |
| 39 |
|
| 40 |
To configure this module, cd to the directory that contains this README file |
| 41 |
and type the following. |
| 42 |
|
| 43 |
perl Makefile.PL |
| 44 |
|
| 45 |
Alternatively, if you plan to install XML::Parser somewhere other than |
| 46 |
your system's perl library directory. You can type something like this: |
| 47 |
|
| 48 |
perl Makefile.PL PREFIX=/home/me/perl INSTALLDIRS=perl |
| 49 |
|
| 50 |
Then to build you run make. |
| 51 |
|
| 52 |
make |
| 53 |
|
| 54 |
You can then test the module by typing: |
| 55 |
|
| 56 |
make test |
| 57 |
|
| 58 |
If you have write access to the perl library directories, you may then |
| 59 |
install by typing: |
| 60 |
|
| 61 |
make install |
| 62 |
|
| 63 |
============= XML::DOM ========================================================= |
| 64 |
|
| 65 |
This is a Perl extension to XML::Parser. It adds a new 'Style' to XML::Parser, |
| 66 |
called 'Dom', that allows XML::Parser to build an Object Oriented datastructure |
| 67 |
with a DOM Level 1 compliant interface. |
| 68 |
For a description of the DOM (Document Object Model), see http://www.w3.org/DOM/ |
| 69 |
|
| 70 |
XML::Parser is a Perl extension interface to James Clark's XML parser, expat. |
| 71 |
It requires at least version 5.004 of perl and can be found on CPAN. |
| 72 |
|
| 73 |
This is a beta version and although there will not be any major API changes, |
| 74 |
minor changes may occur as we get feedback |
| 75 |
from the people on the perl-xml mailing list. [You can subscribe to |
| 76 |
this list by sending a message to [email protected].] |