NAME

    Alien::Libxml2 - Install the C libxml2 library on your system

VERSION

    version 0.20

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 FFI::Platypus script or module:

     use FFI::Platypus;
     use Alien::Libxml2;
    
     my $ffi = FFI::Platypus->new(
       lib => [ Alien::Libxml2->dynamic_libs ],
     );

DESCRIPTION

    This module provides libxml2 for other modules to use.

CAVEATS

    There was an older existing Alien::LibXML, but it uses the older
    Alien::Build::ModuleBuild and the author prefers this version which is
    based on the more robust alienfile system.

    libxml2 has some optional prereqs, including zlib and iconv. For a
    share install you will want to make sure that these are installed prior
    to installing 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 libxml2, zlib and iconv are installed if libxml2 has been
    configured to use them, otherwise XML::LibXML will not install as
    expected. If the tests for this module fail with a missing iconv.h or
    zlib.h, then this is likely the reason.

SEE ALSO

    Alien::LibXML

      Older Alien for the same library.

    XML::LibXML

      Perl interface to libxml2, which uses this Alien

AUTHOR

    Author: Graham Ollis <plicease@cpan.org>

    Contributors:

    Shlomi Fish (shlomif)

    Shawn Laffan (SLAFFAN)

COPYRIGHT AND LICENSE

    This software is copyright (c) 2013-2024 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.

