Revision history for Perl extension XML::LibXML
+2.0201 2019-05-25
+ - Set MIN_PERL_VERSION to 5.8.1.
+ - Alien::Libxml2 Makefile.PL cleanups.
+ - Update the README for grammar and info.
+ - Link to XML-LibXML "by Example"
+ - https://github.com/shlomif/perl-XML-LibXML/pull/36
+ - Thanks to @Grinnz .
+
2.0200 2019-03-23
- Convert to use Alien::Libxml2 .
- https://github.com/shlomif/perl-XML-LibXML/pull/30
use IO::Handle; # for FH reads called as methods
BEGIN {
-$VERSION = "2.0200"; # VERSION TEMPLATE: DO NOT CHANGE
+$VERSION = "2.0201"; # VERSION TEMPLATE: DO NOT CHANGE
$ABI_VERSION = 2;
require Exporter;
require DynaLoader;
several packages which are not described in this section; unless stated
otherwise, you only need to C<<<<<< use XML::LibXML; >>>>>> in your programs.
+Check out XML::LibXML by Example (L<<<<<< http://grantm.github.io/perl-libxml-by-example/ >>>>>>) for a tutorial.
+
For further information, please check the following documentation:
=over 4
=head1 VERSION
-2.0200
+2.0201
=head1 COPYRIGHT
"prereqs" : {
"build" : {
"requires" : {
- "Alien::Libxml2" : "0",
- "Config" : "0",
"ExtUtils::MakeMaker" : "0"
}
},
},
"runtime" : {
"requires" : {
- "Alien::Libxml2" : "0",
"Carp" : "0",
"DynaLoader" : "0",
"Encode" : "0",
"constant" : "0",
"overload" : "0",
"parent" : "0",
+ "perl" : "5.008001",
"strict" : "0",
"vars" : "0",
"warnings" : "0"
},
"test" : {
"requires" : {
+ "Config" : "0",
"Errno" : "0",
"IO::File" : "0",
"IO::Handle" : "0",
"web" : "https://github.com/shlomif/perl-XML-LibXML"
}
},
- "version" : "2.0200",
+ "version" : "2.0201",
"x_serialization_backend" : "JSON::PP version 2.97001"
}
author:
- 'Petr Pajas <PAJAS@cpan.org>'
build_requires:
- Alien::Libxml2: '0'
Config: '0'
Errno: '0'
ExtUtils::MakeMaker: '0'
- inc
- xt
requires:
- Alien::Libxml2: '0'
Carp: '0'
DynaLoader: '0'
Encode: '0'
constant: '0'
overload: '0'
parent: '0'
+ perl: '5.008001'
strict: '0'
vars: '0'
warnings: '0'
resources:
repository: https://github.com/shlomif/perl-XML-LibXML.git
-version: '2.0200'
+version: '2.0201'
x_serialization_backend: 'CPAN::Meta::YAML version 0.018'
use strict;
use warnings;
-require 5.008;
+require 5.008001;
use Alien::Libxml2;
use ExtUtils::MakeMaker;
use Config;
-my %BuildReqs = (
- "Alien::Libxml2" => 0,
- "Config" => 0,
- "ExtUtils::MakeMaker" => 0,
-);
my %ConfigReqs = (
"Alien::Libxml2" => 0,
"Config" => 0,
'Test::TrailingSpace' => 0,
);
my %TestReqs = (
+ "Config" => 0,
"Errno" => 0,
"IO::File" => 0,
"IO::Handle" => 0,
"utf8" => 0,
);
my %prereqs = (
- "Alien::Libxml2" => 0,
"Carp" => 0,
"DynaLoader" => 0,
"Encode" => 0, # actually used in one module. requires Perl 5.8+
"LICENSE" => "perl_5",
"ABSTRACT" => "Interface to Gnome libxml2 xml parsing and DOM library",
"AUTHOR" => "Petr Pajas <PAJAS\@cpan.org>",
+ "MIN_PERL_VERSION" => '5.008001',
"VERSION_FROM" => "LibXML.pm",
'META_MERGE' => {
'dynamic_config' => 0,
"xs",
],
},
- "BUILD_REQUIRES" => \%BuildReqs,
"CONFIGURE_REQUIRES" => \%ConfigReqs,
"TEST_REQUIRES" => \%TestReqs,
"PREREQ_PM" => \%prereqs,
%xsbuild,
);
unless ( eval { ExtUtils::MakeMaker->VERSION('6.63_03') } ) {
- my %fallback = (%prereqs, %TestReqs, %BuildReqs);
+ my %fallback = (%prereqs, %TestReqs);
delete $WriteMakefileArgs{TEST_REQUIRES};
- delete $WriteMakefileArgs{BUILD_REQUIRES};
$WriteMakefileArgs{PREREQ_PM} = \%fallback;
}
delete $WriteMakefileArgs{CONFIGURE_REQUIRES}
unless eval { ExtUtils::MakeMaker->VERSION('6.52') };
+delete $WriteMakefileArgs{MIN_PERL_VERSION}
+ unless eval { ExtUtils::MakeMaker->VERSION('6.48') };
+
delete $WriteMakefileArgs{META_MERGE}
unless eval { ExtUtils::MakeMaker->VERSION('6.46') };
This module implements a Perl interface to the Gnome libxml2 library which
provides interfaces for parsing and manipulating XML files. This module allows
-Perl programmers to make use of the highly capable validating XML parser and
-the high performance DOM implementation.
+Perl programmers to make use of its highly capable validating XML parser and
+its high performance DOM implementation.
IMPORTANT NOTES
XML::LibXML is tested against a couple versions of libxml2 before it is
released. Thus there are versions of libxml2 that are known not to work
properly with XML::LibXML. The Makefile.PL keeps a blacklist of the
-incompatible libxml2 versions.
+incompatible libxml2 versions using Alien::Libxml2. The blacklist itself is
+kept inside its "alienfile" file.
If Makefile.PL detects one of the incompatible versions, it notifies the user.
It may still happen that XML::LibXML builds and pass its tests with such a
problems. If Makefile.PL marks a version of libxml2 as incompatible or broken
it is done for a good reason.
+Full linking information for libxml2 can be obtained by invoking "xml2-config
+--libs".
+
Notes for Microsoft Windows
===========================
Notes for Mac OS X
==================
-Due refactoring the module, XML::LibXML will not run with some earlier versions
-of Mac OS X. It appears that this is related to special linker options for that
-OS prior to version 10.2.2. Since the developers do not have full access to
-this OS, help/ patches from OS X gurus are highly appreciated.
+Due to a refactoring of the module, XML::LibXML will not run with some earlier
+versions of Mac OS X. It appears that this is related to special linker options
+for that OS prior to version 10.2.2. Since the developers do not have full
+access to this OS, help/ patches from OS X gurus are highly appreciated.
It is confirmed that XML::LibXML builds and runs without problems since Mac OS
X 10.2.6.
CONTACT
=======
-For bug reports, please use the CPAN request tracker on
-http://rt.cpan.org/NoAuth/Bugs.html?Dist=XML-LibXML
+For bug reports, please use the issue tracker at
+https://github.com/shlomif/perl-XML-LibXML/issues .
-For suggestions etc. you may contact the maintainer directly at "pajas at ufal
-dot mff dot cuni dot cz", but in general, it is recommended to use the mailing
-list given below.
+For suggestions etc. you may contact the maintainer directly at
+https://www.shlomifish.org/me/contact-me/ , but in general, it is recommended
+to use the mailing list given below.
For suggestions etc., and other issues related to XML::LibXML you may use the
perl XML mailing list (perl-xml@listserv.ActiveState.com), where most
</authorgroup>
- <edition>2.0200</edition>
+ <edition>2.0201</edition>
<copyright>
<year>2001-2007</year>
<holder>AxKit.com Ltd</holder>
<para>This module implements a Perl interface to the Gnome
libxml2 library which provides
interfaces for parsing and manipulating XML files. This
- module allows Perl programmers to make use of the highly
- capable validating XML parser and the high performance DOM
+ module allows Perl programmers to make use of its highly
+ capable validating XML parser and its high performance DOM
implementation.</para>
<sect1>
libxml2 before it is released. Thus there are versions
of libxml2 that are known not to work properly with
XML::LibXML. The Makefile.PL keeps a blacklist of
- the incompatible libxml2 versions.</para>
+ the incompatible libxml2 versions using Alien::Libxml2.
+ The blacklist itself is kept inside its "alienfile"
+ file.</para>
<para>If Makefile.PL detects one of the incompatible versions,
it notifies the user. It may still happen that
reason to assume that it shall work without problems.
If Makefile.PL marks a version of libxml2 as incompatible or broken
it is done for a good reason.</para>
+
+ <para>Full linking information for libxml2 can be obtained
+ by invoking "xml2-config --libs".</para>
</sect2>
<sect2>
<sect2>
<title>Notes for Mac OS X</title>
- <para>Due refactoring the module, XML::LibXML will not
- run with some earlier versions of Mac OS X. It appears that this is related
- to special linker options for that OS prior to version
- 10.2.2. Since the developers do not have full access to this OS,
- help/ patches from OS X gurus are highly
- appreciated.</para>
+ <para>
+ Due to a refactoring of the module, XML::LibXML will
+ not run with some earlier versions of Mac OS X. It
+ appears that this is related to special linker options
+ for that OS prior to version 10.2.2. Since the
+ developers do not have full access to this OS, help/
+ patches from OS X gurus are highly appreciated.
+ </para>
<para>It is confirmed that XML::LibXML builds and runs
without problems since Mac OS X 10.2.6.</para>
<sect1>
<title>Contact</title>
- <para>For bug reports, please use the CPAN request tracker on http://rt.cpan.org/NoAuth/Bugs.html?Dist=XML-LibXML</para>
+ <para>For bug reports, please use the issue tracker at
+ https://github.com/shlomif/perl-XML-LibXML/issues .</para>
- <para>For suggestions etc. you may contact the maintainer directly at "pajas at ufal dot mff dot cuni dot cz", but in general, it is recommended to use the mailing list given below.
+ <para>
+ For suggestions etc. you may contact the maintainer directly at
+ https://www.shlomifish.org/me/contact-me/
+ , but in general, it is recommended to use the mailing
+ list given below.
</para>
<para>For suggestions etc., and other issues
unless stated otherwise, you only need to <literal>use XML::LibXML;</literal>
in your programs.</para>
+ <para>Check out <ulink url="http://grantm.github.io/perl-libxml-by-example/">XML::LibXML by Example</ulink>
+ for a tutorial.</para>
+
<para>For further information, please check the following documentation:</para>
<variablelist>
=head1 VERSION
-2.0200
+2.0201
=head1 COPYRIGHT
our @ISA = qw/Tie::Hash/;
use vars qw($VERSION);
-$VERSION = "2.0200"; # VERSION TEMPLATE: DO NOT CHANGE
+$VERSION = "2.0201"; # VERSION TEMPLATE: DO NOT CHANGE
BEGIN
{
use vars qw ($VERSION);
-$VERSION = "2.0200"; # VERSION TEMPLATE: DO NOT CHANGE
+$VERSION = "2.0201"; # VERSION TEMPLATE: DO NOT CHANGE
use overload
'""' => \&value,
=head1 VERSION
-2.0200
+2.0201
=head1 COPYRIGHT
=head1 VERSION
-2.0200
+2.0201
=head1 COPYRIGHT
@ISA = qw(Exporter);
-$VERSION = "2.0200"; # VERSION TEMPLATE: DO NOT CHANGE
+$VERSION = "2.0201"; # VERSION TEMPLATE: DO NOT CHANGE
use XML::LibXML qw(:libxml);
=head1 VERSION
-2.0200
+2.0201
=head1 COPYRIGHT
=head1 VERSION
-2.0200
+2.0201
=head1 COPYRIGHT
use XML::LibXML;
use vars qw ($VERSION);
-$VERSION = "2.0200"; # VERSION TEMPLATE: DO NOT CHANGE
+$VERSION = "2.0201"; # VERSION TEMPLATE: DO NOT CHANGE
use 5.008_000;
=head1 VERSION
-2.0200
+2.0201
=head1 COPYRIGHT
=head1 VERSION
-2.0200
+2.0201
=head1 COPYRIGHT
=head1 VERSION
-2.0200
+2.0201
=head1 COPYRIGHT
=head1 VERSION
-2.0200
+2.0201
=head1 COPYRIGHT
use warnings;
use vars qw($VERSION);
-$VERSION = "2.0200"; # VERSION TEMPLATE: DO NOT CHANGE
+$VERSION = "2.0201"; # VERSION TEMPLATE: DO NOT CHANGE
use constant ERR_OK => 0;
use constant ERR_INTERNAL_ERROR => 1;
=head1 VERSION
-2.0200
+2.0201
=head1 COPYRIGHT
fallback => 1;
$WARNINGS = 0; # 0: suppress, 1: report via warn, 2: report via die
-$VERSION = "2.0200"; # VERSION TEMPLATE: DO NOT CHANGE
+$VERSION = "2.0201"; # VERSION TEMPLATE: DO NOT CHANGE
use constant XML_ERR_NONE => 0;
use constant XML_ERR_WARNING => 1; # A simple warning
=head1 VERSION
-2.0200
+2.0201
=head1 COPYRIGHT
=head1 VERSION
-2.0200
+2.0201
=head1 COPYRIGHT
use warnings;
use vars qw ($VERSION);
-$VERSION = "2.0200"; # VERSION TEMPLATE: DO NOT CHANGE
+$VERSION = "2.0201"; # VERSION TEMPLATE: DO NOT CHANGE
use overload
'""' => \&value,
=head1 VERSION
-2.0200
+2.0201
=head1 COPYRIGHT
=head1 VERSION
-2.0200
+2.0201
=head1 COPYRIGHT
use XML::LibXML::Number;
use vars qw($VERSION);
-$VERSION = "2.0200"; # VERSION TEMPLATE: DO NOT CHANGE
+$VERSION = "2.0201"; # VERSION TEMPLATE: DO NOT CHANGE
use overload
'""' => \&to_literal,
use warnings;
use vars qw ($VERSION);
-$VERSION = "2.0200"; # VERSION TEMPLATE: DO NOT CHANGE
+$VERSION = "2.0201"; # VERSION TEMPLATE: DO NOT CHANGE
use overload
'""' => \&value,
=head1 VERSION
-2.0200
+2.0201
=head1 COPYRIGHT
=head1 VERSION
-2.0200
+2.0201
=head1 COPYRIGHT
=head1 VERSION
-2.0200
+2.0201
=head1 COPYRIGHT
use warnings;
use vars qw ($VERSION);
-$VERSION = "2.0200"; # VERSION TEMPLATE: DO NOT CHANGE
+$VERSION = "2.0201"; # VERSION TEMPLATE: DO NOT CHANGE
use 5.008_000;
=head1 VERSION
-2.0200
+2.0201
=head1 COPYRIGHT
=head1 VERSION
-2.0200
+2.0201
=head1 COPYRIGHT
=head1 VERSION
-2.0200
+2.0201
=head1 COPYRIGHT
use vars qw($VERSION @ISA);
-$VERSION = "2.0200"; # VERSION TEMPLATE: DO NOT CHANGE
+$VERSION = "2.0201"; # VERSION TEMPLATE: DO NOT CHANGE
use XML::LibXML;
use XML::SAX::Base;
=head1 VERSION
-2.0200
+2.0201
=head1 COPYRIGHT
return $XML::LibXML::__threads_shared ? 0 : 1;
}
-$VERSION = "2.0200"; # VERSION TEMPLATE: DO NOT CHANGE
+$VERSION = "2.0201"; # VERSION TEMPLATE: DO NOT CHANGE
sub new {
my $class = shift;
=head1 VERSION
-2.0200
+2.0201
=head1 COPYRIGHT
use XML::LibXML;
use vars qw ($VERSION);
-$VERSION = "2.0200"; # VERSION TEMPLATE: DO NOT CHANGE
+$VERSION = "2.0201"; # VERSION TEMPLATE: DO NOT CHANGE
sub CLONE_SKIP {
return $XML::LibXML::__threads_shared ? 0 : 1;
use XML::SAX::Base;
use XML::SAX::DocumentLocator;
-$VERSION = "2.0200"; # VERSION TEMPLATE: DO NOT CHANGE
+$VERSION = "2.0201"; # VERSION TEMPLATE: DO NOT CHANGE
@ISA = ('XML::SAX::Base');
sub CLONE_SKIP {
=head1 VERSION
-2.0200
+2.0201
=head1 COPYRIGHT
=head1 VERSION
-2.0200
+2.0201
=head1 COPYRIGHT
use XML::LibXML;
use XML::LibXML::NodeList;
-$VERSION = "2.0200"; # VERSION TEMPLATE: DO NOT CHANGE
+$VERSION = "2.0201"; # VERSION TEMPLATE: DO NOT CHANGE
# should LibXML XPath data types be used for simple objects
# when passing parameters to extension functions (default: no)
=head1 VERSION
-2.0200
+2.0201
=head1 COPYRIGHT
=head1 VERSION
-2.0200
+2.0201
=head1 COPYRIGHT