README
1 XML::Parser Version 2.31
2
3Copyright (c) 1998-2000 Larry Wall and Clark Cooper.
4All rights reserved.
5This program is free software; you can redistribute it and/or modify it
6under the same terms as Perl itself.
7
8This is a Perl extension interface to James Clark's XML parser, expat.
9It requires at least version 5.004 of perl and it requires that you have
10release 1.95.0 or greater of expat installed. You can download expat
11from:
12
13 http://sourceforge.net/projects/expat/
14
15The documentation for this extension can be found in pod format at the end
16of the files Parser.pm and Expat/Expat.pm. The perldoc program, provided with
17the perl distribution, can be used to view this documentation.
18
19This was modified from the original XML::Parser created by Larry Wall.
20
21To configure this module, cd to the directory that contains this README file
22and type the following:
23
24 perl Makefile.PL
25
26Alternatively, if you plan to install XML::Parser somewhere other than
27your system's perl library directory. You can type something like this:
28
29 perl Makefile.PL PREFIX=/home/me/perl INSTALLDIRS=perl
30
31Then to build you run make.
32
33 make
34
35You can then test the module by typing:
36
37 make test
38
39There are some sample utilities in the samples directory along with an
40xml form of the XML specification to test them on. You may need to change
41the '#!' line at the top of these utilities to what is appropriate for
42your system. If you're going to play around with them prior to installing
43the module, you would need to add the blib paths to your perl search
44path, like this (assuming your current directory is samples):
45
46 perl -I../blib/lib -I../blib/arch xmlcomments REC-xml-19980210.xml
47
48or set your PERLLIB environment variable.
49
50If you have write access to the installation directories, you may then
51install by typing:
52
53 make install
54
55Discussion on features and bugs of this software and general discussion
56on topics relating to perl and XML takes place on the perl-xml mailing
57list, to which you can subscribe by sending mail to:
58
59 subscribe-perl-xml@lyris.activestate.com
60
61Differences from Version 2.30
62=============================
63
64Version 2.31 is a minor bugfix release to allow XML::Parser to
65work under the forthcoming Perl 5.8.0 release. There are no functional
66changes.
67
68Differences from Version 2.29
69=============================
70
71Expat is no longer included with this package. It must now be already
72installed on your system as a library. You may download the library
73version of expat from http://sourceforge.net/projects/expat/. After
74downloading, expat must be configured (an automatic script does this),
75built and installed.
76
77A workaround has been provided for those people who couldn't compile
78Expat.xs with a perl 5.6.0 with USE_5005THREADS on.
79
80A bug that prevented IO::Handler from being read by the parse method
81has been fixed.
82
83Fixed a bug in reading external entities with incremental parsing.
84
85Clark Cooper
86 coopercc@netheaven.com
87