Initial Commit

database/perl/vendor/lib/Alien/Libxml2.pm

@@ -0,0 +1,120 @@
+package Alien::Libxml2;
+
+use strict;
+use warnings;
+use base qw( Alien::Base );
+
+# ABSTRACT: Install the C libxml2 library on your system
+our $VERSION = '0.17'; # VERSION
+
+
+
+
+1;
+
+__END__
+
+=pod
+
+=encoding UTF-8
+
+=head1 NAME
+
+Alien::Libxml2 - Install the C libxml2 library on your system
+
+=head1 VERSION
+
+version 0.17
+
+=head1 SYNOPSIS
+
+In your Makefile.PL:
+
+ use ExtUtils::MakeMaker;
+ use Alien::Base::Wrapper ();
+
+ WriteMakefile(
+   Alien::Base::Wrapper->new('Alien::Libxml2')->mm_args2(
+     # MakeMaker args
+     NAME => 'My::XS',
+     ...
+   ),
+ );
+
+In your Build.PL:
+
+ use Module::Build;
+ use Alien::Base::Wrapper qw( Alien::Libxml2 !export );
+
+ my $builder = Module::Build->new(
+   ...
+   configure_requires => {
+     'Alien::Libxml2' => '0',
+     ...
+   },
+   Alien::Base::Wrapper->mb_args,
+   ...
+ );
+
+ $build->create_build_script;
+
+In your L<FFI::Platypus> script or module:
+
+ use FFI::Platypus;
+ use Alien::Libxml2;
+
+ my $ffi = FFI::Platypus->new(
+   lib => [ Alien::Libxml2->dynamic_libs ],
+ );
+
+=head1 DESCRIPTION
+
+This module provides C<libxml2> for other modules to use.
+
+=head1 CAVEATS
+
+There was an older existing L<Alien::LibXML>, but it uses the older
+L<Alien::Build::ModuleBuild> and the author prefers this version which
+is based on the more robust L<alienfile> system.
+
+C<libxml2> has some optional prereqs, including C<zlib> and C<iconv>.
+For a C<share> install you will want to make sure that these are installed
+prior to installing L<Alien::Libxml2> if you want to make use of features
+relying on them.
+
+For a system install, you want to make sure the development packages for
+C<libxml2>, C<zlib> and C<iconv> are installed if C<libxml2> has been
+configured to use them, otherwise L<XML::LibXML> will not install as
+expected.  If the tests for this module fail with a missing C<iconv.h>
+or C<zlib.h>, then this is likely the reason.
+
+=head1 SEE ALSO
+
+=over 4
+
+=item L<Alien::LibXML>
+
+Older Alien for the same library.
+
+=item L<XML::LibXML>
+
+Perl interface to C<libxml2>, which uses this L<Alien>
+
+=back
+
+=head1 AUTHOR
+
+Author: Graham Ollis E<lt>plicease@cpan.orgE<gt>
+
+Contributors:
+
+Shlomi Fish (shlomif)
+
+=head1 COPYRIGHT AND LICENSE
+
+This software is copyright (c) 2013 by Graham Ollis.
+
+This is free software; you can redistribute it and/or modify it under
+the same terms as the Perl 5 programming language system itself.
+
+=cut