/ 
Perl-Dist-1.00
River stage zero No dependents
/ Perl::Dist::Bootstrap

NAME

Perl::Dist::Bootstrap - A bootstrap Perl for building Perl distributions

DESCRIPTION

"Bootstrap Perl" is a Perl distribution, and a member of the "Vanilla Perl" series of distributions.

The Perl::Dist::Bootstrap module can be used in conjunction wit the perldist command line tool to create a bootstrap Perl distribution.

Most of the time nobody will be using Perl::Dist::Bootstrap directly, but will be downloading the pre-built installer for Bootstrap Perl from the Vanilla Perl website at http://vanillaperl.com/.

Why Is This Needed?

For people building Win32 Perl distributions based on Perl::Dist, one gotcha is that the distributions have hard-coded install paths.

As a result of this, it is not possible to use a distribution to build a new/modified version of the same distribution.

To compensate for this, and make the process of building custom distributions easier, this distribution has been created.

As an additional convenience, Bootstrap Perl comes with Perl::Dist, and several distribution subclasses (Perl::Dist::Vanilla, Perl::Dist::Strawberry etc) already installed, as well as some additional Perl development tools that might be useful during the Perl distribution creation process.

CONFIGURATION

Bootstrap Perl must be installed in C:\bootstrap. The executable installer adds the following environment variable changes:

* adds directories to PATH
    - C:\bootstrap\perl\bin
    - C:\bootstrap\c\bin

* adds directories to LIB
    - C:\bootstrap\c\lib
    - C:\bootstrap\perl\bin

* adds directories to INCLUDE 
    - C:\bootstrap\c\include
    - C:\bootstrap\perl\lib\CORE

LIB and INCLUDE changes are likely more than are necessary, but attempt to head off potential problems compiling external programs for use with Perl.

The "cpan" program is pre-configured with a known-good setup, but you may wish to reconfigure it.

Manual CPAN configuration may be repeated by running the following command:

perl -MCPAN::FirstTime -e "CPAN::FirstTime::init"

SUPPORT

Bootstrap Perl discussion is centered at http://win32.perl.org/.

Other venues for discussion may be listed there.

Please report bugs or feature requests using the CPAN Request Tracker. Bugs can be sent by email to bug-Perl-Dist-Bootstrap@rt.cpan.org or submitted using the web interface at http://rt.cpan.org/Dist/Display.html?Queue=Perl-Dist-Bootstrap

AUTHOR

Adam Kennedy <adamk@cpan.org>

COPYRIGHT

Copyright 2007 - 2008 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 module.