NAME

Perl::Dist::WiX::Libraries - Library installation routines

VERSION

This document describes Perl::Dist::WiX::Libraries version 1.250.

DESCRIPTION

This module provides the routines that Perl::Dist::WiX uses in order to install the C toolchain and library files.

SYNOPSIS

# This module is not to be used independently.
# It provides methods to be called on a Perl::Dist::WiX object.

INTERFACE

library_directory

$dist->library_directory()

The library_directory method returns the correct directory on the strawberryperl.com server for libraries, given the bits() and gcc_version() values.

install_gcc_toolchain

$dist->install_gcc_toolchain()

The install_gcc_toolchain method installs the corrent gcc toolchain into the distribution, and is typically installed during "C toolchain" build phase.

It provides the approproate arguments to install_binary and then validates that the binary was installed correctly.

Returns true or throws an exception on error.

install_dmake

$dist->install_dmake()

The install_dmake method installs the dmake make tool into the distribution, and is typically installed during "C toolchain" build phase.

It provides the approproate arguments to install_binary and then validates that the binary was installed correctly.

Returns true or throws an exception on error.

install_pexports

$dist->install_pexports()

The install_pexports method installs the MinGW pexports package into the distribution.

This is needed by some libraries to let the Perl interfaces build against them correctly.

Returns true or throws an exception on error.

install_mingw_make

$dist->install_mingw_make()

The install_mingw_make method installs the MinGW build of the GNU make build tool.

While GNU make is not used by Perl itself, some C libraries can't be built using the normal dmake tool and explicitly need GNU make. So we install it as mingw-make and certain Alien:: modules will use it by that name.

Returns true or throws an exception on error.

DIAGNOSTICS

See Perl::Dist::WiX::Diagnostics for a list of exceptions that this module can throw.

BUGS AND LIMITATIONS (SUPPORT)

Bugs should be reported via:

1) The CPAN bug tracker at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Perl-Dist-WiX if you have an account there.

2) Email to <bug-Perl-Dist-WiX@rt.cpan.org> if you do not.

For other issues, contact the topmost author.

AUTHORS

Curtis Jewell <csjewell@cpan.org>

SEE ALSO

Perl::Dist::WiX, http://ali.as/, http://csjewell.comyr.com/perl/

COPYRIGHT AND LICENSE

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 distribution.