NAME

Perl::Dist::Strawberry::Libraries - Library installation routines for Strawberry Perl

SYNOPSIS

# This is used as an 'additive base" class for 
# Perl::Dist::Strawberry and is not intended for use outside of 
# Perl::Dist::Strawberry subclasses.

DESCRIPTION

Strawberry Perl is a binary distribution of Perl for the Windows operating system. It includes a bundled compiler and pre-installed modules that offer the ability to install XS CPAN modules directly from CPAN.

The purpose of the Strawberry Perl series is to provide a practical Win32 Perl environment for experienced Perl developers to experiment with and test the installation of various CPAN modules under Win32 conditions, and to provide a useful platform for doing real work.

INTERFACE

This class adds additional methods that provide installation support for tools that are included in Strawberry Perl.

install_patch

$dist->install_patch;

The install_patch method can be used to install a copy of the Unix patch program into the distribution.

Returns true or throws an exception on error.

bin_patch

$dist->bin_patch;

The bin_patch method returns the location of the patch.exe file installed by "install_patch".

install_ppm

$dist->install_ppm;

Installs the PPM module, and then customises the temp path to live underneath the strawberry dist.

install_win32_manifest

$dist->install_win32_manifest( 'WX Perl' => 'perl', 'bin', 'wxperl.exe' );

Installs a manifest file to make an executable binary look like a "real" Win32 program.

install_dbd_mysql

$dist->install_dbd_mysql;

Installs DBD::mysql from the PAR files on the Strawberry Perl web site.

install_dbd_pg

$dist->install_dbd_pg;

Installs DBD::Pg from the PAR files on the Strawberry Perl web site.

install_pari

$dist->install_pari

The install_pari method install (via a PAR package) libpari and the Math::Pari module into the distribution.

This method should only be called at during the install_modules phase.

install_zlib

$dist->install_zlib

The install_zlib method installs the GNU zlib compression library into the distribution, and is typically installed during "C toolchain" build phase.

It provides the appropriate arguments to a install_library call that will extract the standard zlib win32 package, and generate the additional files that Perl needs.

Returns true or throws an exception on error.

install_libiconv

$dist->install_libiconv

The install_libiconv method installs the GNU libiconv library, which is used for various character encoding tasks, and is needed for other libraries such as libxml.

Returns true or throws an exception on error.

install_libxml

$dist->install_libxml

The install_libxml method installs the Gnome libxml library, which is a fast, reliable, XML parsing library, and the new standard library for XML parsing.

Returns true or throws an exception on error.

install_expat

$dist->install_expat

The install_expat method installs the Expat XML library, which was the first popular C XML parser. Many Perl XML libraries are based on Expat.

Returns true or throws an exception on error.

install_gmp

$dist->install_gmp

The install_gmp method installs the GNU Multiple Precision Arithmetic Library, which is used for fast and robust bignum support.

Returns true or throws an exception on error.

install_libdb

$dist->install_libdb;

The install_libdb method can be used to install a copy of the Berkeley DB library.

Returns true or throws an exception on error.

SUPPORT

Bugs should be reported via the CPAN bug tracker at

http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Perl-Dist-Strawberry

Please note that only bugs in the distribution itself or the CPAN configuration should be reported to RT. Bugs in individual modules should be reported to their respective distributions.

For more support information and places for discussion, see the Strawberry Perl Support page http://strawberryperl.com/support.html.

AUTHOR

Adam Kennedy <adamk@cpan.org>

Curtis Jewell <csjewell@cpan.org>

COPYRIGHT

Copyright 2007 - 2009 Adam Kennedy.

Copyright 2009 - 2010 Curtis Jewell.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

The full text of the license can be found in the LICENSE file included with this module.