NAME

Perl::Dist::WiX::Mixin::BuildPerl - 4th generation Win32 Perl distribution builder

VERSION

This document describes Perl::Dist::WiX::Mixin::BuildPerl version 1.500002.

DESCRIPTION

This module provides (most of) the routines that Perl::Dist::WiX uses in order to build Perl itself.

SYNOPSIS

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

INTERFACE

install_cpan_upgrades

The install_cpan_upgrades method is provided to upgrade all the modules that were installed with Perl that were not upgraded by the install_perl_toolchain subroutine.

Returns true or throws an exception.

This is recommended to be used as a task in the tasklist, and is in the default tasklist after the "perl toolchain" is installed.

when (
	/Unicode-Normalize-1 [.] (\d\d)-withoutworldwriteables/msx)
{
	$self->install_distribution(
		name     => "SADAHIRO/Unicode-Normalize-1.$1.tar.gz",
		mod_name => 'Unicode::Normalize',
		$self->_install_location(1),
		$self->_force_flag($default_force),
	);
}

install_perl

The install_perl method is a minimal routine provided to call the _install_perl_plugin routine (which the "perl version" plugins provide.)

Returns true or throws an exception.

This is recommended to be used as a task in the tasklist, and is in the default tasklist after the "c toolchain" is installed.

install_perl_toolchain

The install_perl_toolchain method is a routine provided to install the "perl toolchain": the modules required for CPAN and CPANPLUS to be able to install modules.

Returns true (technically, the object that called it), or throws an exception.

This is recommended to be used as a task in the tasklist, and is in the default tasklist after the perl interpreter is installed.

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>

Adam Kennedy <adamk@cpan.org>

SEE ALSO

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

COPYRIGHT AND LICENSE

Copyright 2009 - 2011 Curtis Jewell.

Copyright 2008 - 2009 Adam Kennedy.

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.