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.