XML::LibXML
===========
This module implements much of the DOM Level 2 API as an
interface to the Gnome libxml2 library. This makes it a fast
and highly capable validating XML parser library, as well as
a high performance DOM.
IMPORTANT NOTE
==============
XML::LibXML was almost entirely reimplemented between version 1.40
to version 1.49. This may cause problems on some production machines.
with version 1.50 a lot of compatibility fixes were applied, so
programs written for XML::LibXML 1.40 or less should run with
version 1.50 again.
Installation
============
Prior to installation you MUST have installed the libxml2
library. You can get the latest libxml2 version from
http://xmlsoft.org
Then run:
$ perl Makefile.PL
$ make test
$ su
$ make install
Parser documentation is in perldoc XML::LibXML. DOM documentation
starts in perldoc XML::LibXML::Document and perldoc
XML::LibXML::Node.
If your libxml2 installation is not within your $PATH. you can set
the environment variable XMLPREFIX=$YOURLIBXMLPREFIX to make
XML::LibXML recognize the correct libxml2 version in use.
e.g.
$ XMLPREFIX=/usr/brand-new perl Makefile.PL
will ask '/usr/brand-new/bin/xml2-config' about your real
libxml2 configuration.
NOTES FOR HPUX
==============
XML::LibXML requires libxml2 2.4.20 or later. That means the current
binary libxml2 package for HPUX cannot be used with XML::LibXML. For
some reasons the HPUX cc will not compile libxml2 correct, which will
force you to recompile perl with gcc (if you havn't already done that).
Additionally I got these Note from Rozi Kovesdi:
> Here is my report if someone else runs into the same problem:
>
> Finally I am done with installing all the libraries and XML Perl
> modules
>
> The combination that worked best for me was:
> gcc
> GNU make
>
> Most important - before trying to install Perl modules that depend on
> libxml2:
>
> must set SHLIB_PATH to include the path to libxml2 shared library
>
> assuming that you used the default:
>
> export SHLIB=/usr/local/lib
>
> also, make sure that the config files have execute permission:
>
> /usr/local/bin/xml2-config
> /usr/local/bin/xslt-config
>
> they did not have +x after they were installed by 'make install'
> and it took me a while to realize that this was my problem
>
> or one can use:
>
> perl Makefile.PL LIBS='-L/path/to/lib' INC='-I/path/to/include'
NOTES FOR M$ Windows
====================
Thanks to Randy Kobes there is a precompiled PPM package available on
http://theoryx5.uwinnipeg.ca/ppmpackages/
Usually it takes a little time to build the package for the latest
release.
Contact
=======
For suggestions, bugreports etc. you may contact the maintainer directly
christian.glahn@uibk.ac.at
Also XML::LibXML issues are discussed among other things on the
perl XML mailing list (perl-xml@listserv.ActiveState.com)
Package History
===============
Version < 0.98 were implemented by Matt Sergeant
0.98 > Version > 1.49 were maintained by Matt Sergeant and Christian Glahn
Version >= 1.49 are maintained by Christian Glahn
License
=======
This is free software, you may use it and distribute it under the same
terms as Perl itself.
Copyright 2001-2002 AxKit.com Ltd, All rights reserved.