From: Karen Etheridge Date: Wed, 4 Sep 2013 23:22:22 +0000 (-0700) Subject: add bullets to LIMITATIONS section X-Git-Tag: 1.008012~3 X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=p5sagit%2Flocal-lib.git;a=commitdiff_plain;h=788ea14692f083128b280e85ec9df2b9108b9272 add bullets to LIMITATIONS section --- diff --git a/lib/local/lib.pm b/lib/local/lib.pm index b21e04e..440757a 100644 --- a/lib/local/lib.pm +++ b/lib/local/lib.pm @@ -971,29 +971,37 @@ install UNINST=1" and local::lib if you understand these possible consequences. =head1 LIMITATIONS -The perl toolchain is unable to handle directory names with spaces in it, +=over 4 + +=item * The perl toolchain is unable to handle directory names with spaces in it, so you can't put your local::lib bootstrap into a directory with spaces. What you can do is moving your local::lib to a directory with spaces B you installed all modules inside your local::lib bootstrap. But be aware that you can't update or install CPAN modules after the move. -Rather basic shell detection. Right now anything with csh in its name is +=item * Rather basic shell detection. Right now anything with csh in its name is assumed to be a C shell or something compatible, and everything else is assumed to be Bourne, except on Win32 systems. If the C environment variable is not set, a Bourne-compatible shell is assumed. -Bootstrap is a hack and will use CPAN.pm for ExtUtils::MakeMaker even if you +=item * Bootstrap is a hack and will use CPAN.pm for ExtUtils::MakeMaker even if you have CPANPLUS installed. -Kills any existing PERL5LIB, PERL_MM_OPT or PERL_MB_OPT. +=item * Kills any existing PERL5LIB, PERL_MM_OPT or PERL_MB_OPT. -Should probably auto-fixup CPAN config if not already done. +=item * Should probably auto-fixup CPAN config if not already done. + +=back Patches very much welcome for any of the above. -On Win32 systems, does not have a way to write the created environment variables +=over 4 + +=item * On Win32 systems, does not have a way to write the created environment variables to the registry, so that they can persist through a reboot. +=back + =head1 TROUBLESHOOTING If you've configured local::lib to install CPAN modules somewhere in to your