Perl module: XML-DOM

Copyright (c) 1999,2000 Enno Derksen
All rights reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

The XML::DOM code is fairly stable and has been used quite a bit.

However, there is a new DOM module, XML::GDOME which is under active development and significantly faster than XML::DOM, since it is based on the libgdome C library. It provides Level 2 of the DOM Core API. For more details see http://tjmather.com/xml-gdome/

Patches welcome! Send them to tjmather@maxmind.com

Paid support is available from directly from the maintainers of this package. Please see http://www.maxmind.com/app/opensourceservices for more details.

========= DEPENDENCIES =========================================================

You need the following modules (all available at CPAN):

• Perl 5.6.0 or higher (can run under earlier versions, simply remove

  use bytes; from lib/XML/DOM.pm)

• XML::RegExp
• XML::Parser (At least version 2.28, 2.30 recommended)

  If you are using XML::Parser 2.27, then you should download libxml-enno-1.02 from your local CPAN mirror. If you are using Perl 5.8.0 or greater and XML::Parser 2.32 or lesser, you must apply the included XML-Parser-2.31.patch.

• LWP::UserAgent (It's part of libwww-perl. If you don't have it, some test

  cases may fail and you can't read files from URLs.)

• XML::Parser::PerlSAX (It's part of libxml-perl. You need at least version 0.06.

  If you don't have it some test cases may fail.)

========= INSTALLATION =========================================================

To configure this module, cd to the directory that contains this README file and type the following.

perl Makefile.PL

Alternatively, if you plan to install XML::Parser somewhere other than your system's perl library directory. You can type something like this:

perl Makefile.PL PREFIX=/home/me/perl INSTALLDIRS=perl

Then to build you run make.

make

You can then test the module by typing:

make test

If you have write access to the perl library directories, you may then install by typing:

make install

============= XML::DOM =========================================================

This is a Perl extension to XML::Parser. It adds a new 'Style' to XML::Parser, called 'Dom', that allows XML::Parser to build an Object Oriented datastructure with a DOM Level 1 compliant interface. For a description of the DOM (Document Object Model), see http://www.w3.org/DOM/

XML::Parser is a Perl extension interface to James Clark's XML parser, expat. It requires at least version 5.004 of perl and can be found on CPAN.

This is a beta version and although there will not be any major API changes, minor changes may occur as we get feedback from the people on the perl-xml mailing list. [You can subscribe to this list by sending a message to subscribe-perl-xml@listserv.activestate.com.]