Debian Codegraph @

README

raw
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].]