NAME

Alien::Iconv - install a local iconv just for Perl

DESCRIPTION

This module allows you to install a local instance of the libiconv library via CPAN (or CPANPLUS).

It does not yet try to find an already existing instance but will always install a new library. If this is not what you want, submit patches.

INSTALLATION

This package downloads the full libiconv sources as found at http://ftp.gnu.org/pub/gnu/libiconv/ at installation time.

If you don't want the download, create a directory src and put the compressed file as src/libiconv-1.9.2.tar.gz in the build directory.

METHODS

This package exports the following methods to query the installation directories:

prefix();

Returns the prefix (ie, the directory) where the include and lib directores will live. On a standard unix system, this might be /usr/local/

For this module, it will be $INC{'Alien/Iconv'}.

lib();

Returns the full path to the lib directory for the libxml2 libraries. On standard unix systems, this might be /usr/local/lib

For this module, it will be $INC{'Alien/Iconv'}/lib

include()

Returns the full path to the include directory for the libpng libraries. On standard unix systems, this might be /usr/local/include

For this module, it will be $INC{'Alien/Iconv'}/include

version()

Returns the version of the zlib libraries installed by this version of Alien::XML::LibXML

lib_files()

Returns a list of full paths to the files that can be found in the Alien::XML::LibXML->lib directory. This corresponds to all created libraries.

include_files()

Returns a list of full paths to the files that can be found in the Alien::XML::LibXML->include direcotry. This corresponds to all copied header files.

archives()

Returns the archive filenames. In this case it's ...

lib_version()

Returns the version of the linked library.

urls()

Returns the urls to fetch the source code from.

TODO

LICENSE

The Perl code in this distribution can be distributed under the same terms as Perl itself. The libxml2 code is copyright (c) 2001 by the JFIF and has the following copyright note:

AUTHOR

The author of the Perl code in this package is Max Maischein corion@cpan.org. Much of the code was cannibalized from Alien::Zlib. The authors of the libxml2 libraries are noted in the README text file of the libxml2 distribution.

POD ERRORS

Hey! The above document had some coding errors, which are explained below:

Around line 159:

You forgot a '=back' before '=head1'