<h2>Editing File: /usr/share/perl5/blib.pm</h2><form method='post'><textarea name='content' class='file-edit'>package blib;

=head1 NAME

blib - Use MakeMaker's uninstalled version of a package

=head1 SYNOPSIS

 perl -Mblib script [args...]

 perl -Mblib=dir script [args...]

=head1 DESCRIPTION

Looks for MakeMaker-like I&lt;'blib'&gt; directory structure starting in
I&lt;dir&gt; (or current directory) and working back up to five levels of '..'.

Intended for use on command line with B&lt;-M&gt; option as a way of testing
arbitrary scripts against an uninstalled version of a package.

However it is possible to :

 use blib;
 or
 use blib '..';

etc. if you really must.

=head1 BUGS

Pollutes global name space for development only task.

=head1 AUTHOR

Nick Ing-Simmons nik@tiuk.ti.com

=cut

use Cwd;
use File::Spec;

use vars qw($VERSION $Verbose);
$VERSION = '1.06';
$Verbose = 0;

sub import
{
 my $package = shift;
 my $dir;
 if ($^O eq &quot;MSWin32&quot; &amp;&amp; -f &quot;Win32.xs&quot;) {
     # We don't use getcwd() on Windows because it will internally
     # call Win32::GetCwd(), which will get the Win32 module loaded.
     # That means that it would not be possible to run `make test`
     # for the Win32 module because blib.pm would always load the
     # installed version before @INC gets updated with the blib path.
     chomp($dir = `cd`);
 }
 else {
     $dir = getcwd;
 }
 if ($^O eq 'VMS') { ($dir = VMS::Filespec::unixify($dir)) =~ s-/\z--; }
 if (@_)
  {
   $dir = shift;
   $dir =~ s/blib\z//;
   $dir =~ s,/+\z,,;
   $dir = File::Spec-&gt;curdir unless ($dir);
   die &quot;$dir is not a directory\n&quot; unless (-d $dir);
  }

 # detaint: if the user asked for blib, s/he presumably knew
 # what s/he wanted
 $dir = $1 if $dir =~ /^(.*)$/;

 my $i = 5;
 my($blib, $blib_lib, $blib_arch);
 while ($i--)
  {
   $blib = File::Spec-&gt;catdir($dir, &quot;blib&quot;);
   $blib_lib = File::Spec-&gt;catdir($blib, &quot;lib&quot;);
   $blib_arch = File::Spec-&gt;catdir($blib, &quot;arch&quot;);

   if (-d $blib &amp;&amp; -d $blib_arch &amp;&amp; -d $blib_lib)
    {
     unshift(@INC,$blib_arch,$blib_lib);
     warn &quot;Using $blib\n&quot; if $Verbose;
     return;
    }
   $dir = File::Spec-&gt;catdir($dir, File::Spec-&gt;updir);
  }
 die &quot;Cannot find blib even in $dir\n&quot;;
}

1;
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Fusr%2Fshare%2Fperl5'>Back to Directory</a>