The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

CPAN::PERL5INC - Keep all tested and not installed modules in INC

SYNOPSIS

  PERL5OPT="-MCPAN::PERL5INC=yaml_module,$y,tempfile,$t";

DESCRIPTION

CPAN.pm keeps track of tested but not yet installed modules. To make these modules available to modules that are tested later, it normally populates the environment variable PERL5LIB.

This module is an alternative to PERL5LIB that circumvents limitations of the size of the environment. The import routine is abused to let the caller set a YAML module and a tempfile. The YAML module will then be used to load the tempfile. The loaded object must be a hash and the array reference in the inc slot of that hash will be appended to @INC.

When the number of tested but uninstalled distros grows, CPAN tries to use this module after the threshold threshold_perl5lib_upto is reached. It issues a warning when this is not feasible. A YAML module should be installed and File::Temp should be available in order to get it working.

BUGS

Does not work with paths containing comma. Does not work when the environment variable PERL5OPT is already in use for something else. Tests that have tainting turned on often fail when PERL5OPT is set because the variable is then ignored.

LICENSE

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

See http://www.perl.com/perl/misc/Artistic.html