Upgrade to ExtUtils-MakeMaker-6.32. Included a version
[p5sagit/p5-mst-13.2.git] / lib / ExtUtils / Liblist.pm
index 09421e3..3596621 100644 (file)
 package ExtUtils::Liblist;
 
-@ISA = qw(ExtUtils::Liblist::Kid File::Spec);
-
-sub lsdir {
-  shift;
-  my $rex = qr/$_[1]/;
-  opendir my $dir, $_[0];
-  grep /$rex/, readdir $dir;
-}
-
-sub file_name_is_absolute {
-  require File::Spec;
-  shift;
-  'File::Spec'->file_name_is_absolute(@_);
-}
-
-
-package ExtUtils::Liblist::Kid;
-
-# This kid package is to be used by MakeMaker.  It will not work if
-# $self is not a Makemaker.
+use strict;
 
-use 5.006_001;
-# Broken out of MakeMaker from version 4.11
+use vars qw($VERSION @ISA);
+$VERSION = '1.03';
 
-our $VERSION = substr q$Revision: 1.27 $, 10;
-
-use Config;
-use Cwd 'cwd';
-use File::Basename;
+use File::Spec;
+require ExtUtils::Liblist::Kid;
+@ISA = qw(ExtUtils::Liblist::Kid File::Spec);
 
+# Backwards compatibility with old interface.
 sub ext {
-  if   ($^O eq 'VMS')     { return &_vms_ext;      }
-  elsif($^O eq 'MSWin32') { return &_win32_ext;    }
-  else                    { return &_unix_os2_ext; }
-}
-
-sub _unix_os2_ext {
-    my($self,$potential_libs, $verbose, $give_libs) = @_;
-    if ($^O =~ 'os2' and $Config{perllibs}) { 
-       # Dynamic libraries are not transitive, so we may need including
-       # the libraries linked against perl.dll again.
-
-       $potential_libs .= " " if $potential_libs;
-       $potential_libs .= $Config{perllibs};
-    }
-    return ("", "", "", "", ($give_libs ? [] : ())) unless $potential_libs;
-    warn "Potential libraries are '$potential_libs':\n" if $verbose;
-
-    my($so)   = $Config{'so'};
-    my($libs) = $Config{'perllibs'};
-    my $Config_libext = $Config{lib_ext} || ".a";
-
-
-    # compute $extralibs, $bsloadlibs and $ldloadlibs from
-    # $potential_libs
-    # this is a rewrite of Andy Dougherty's extliblist in perl
-
-    my(@searchpath); # from "-L/path" entries in $potential_libs
-    my(@libpath) = split " ", $Config{'libpth'};
-    my(@ldloadlibs, @bsloadlibs, @extralibs, @ld_run_path, %ld_run_path_seen);
-    my(@libs, %libs_seen);
-    my($fullname, $thislib, $thispth, @fullname);
-    my($pwd) = cwd(); # from Cwd.pm
-    my($found) = 0;
-
-    foreach $thislib (split ' ', $potential_libs){
-
-       # Handle possible linker path arguments.
-       if ($thislib =~ s/^(-[LR])//){  # save path flag type
-           my($ptype) = $1;
-           unless (-d $thislib){
-               warn "$ptype$thislib ignored, directory does not exist\n"
-                       if $verbose;
-               next;
-           }
-           unless ($self->file_name_is_absolute($thislib)) {
-             warn "Warning: $ptype$thislib changed to $ptype$pwd/$thislib\n";
-             $thislib = $self->catdir($pwd,$thislib);
-           }
-           push(@searchpath, $thislib);
-           push(@extralibs,  "$ptype$thislib");
-           push(@ldloadlibs, "$ptype$thislib");
-           next;
-       }
-
-       # Handle possible library arguments.
-       unless ($thislib =~ s/^-l//){
-         warn "Unrecognized argument in LIBS ignored: '$thislib'\n";
-         next;
-       }
-
-       my($found_lib)=0;
-       foreach $thispth (@searchpath, @libpath){
-
-               # Try to find the full name of the library.  We need this to
-               # determine whether it's a dynamically-loadable library or not.
-               # This tends to be subject to various os-specific quirks.
-               # For gcc-2.6.2 on linux (March 1995), DLD can not load
-               # .sa libraries, with the exception of libm.sa, so we
-               # deliberately skip them.
-           if (@fullname =
-                   $self->lsdir($thispth,"^\Qlib$thislib.$so.\E[0-9]+")){
-               # Take care that libfoo.so.10 wins against libfoo.so.9.
-               # Compare two libraries to find the most recent version
-               # number.  E.g.  if you have libfoo.so.9.0.7 and
-               # libfoo.so.10.1, first convert all digits into two
-               # decimal places.  Then we'll add ".00" to the shorter
-               # strings so that we're comparing strings of equal length
-               # Thus we'll compare libfoo.so.09.07.00 with
-               # libfoo.so.10.01.00.  Some libraries might have letters
-               # in the version.  We don't know what they mean, but will
-               # try to skip them gracefully -- we'll set any letter to
-               # '0'.  Finally, sort in reverse so we can take the
-               # first element.
-
-               #TODO: iterate through the directory instead of sorting
-
-               $fullname = "$thispth/" .
-               (sort { my($ma) = $a;
-                       my($mb) = $b;
-                       $ma =~ tr/A-Za-z/0/s;
-                       $ma =~ s/\b(\d)\b/0$1/g;
-                       $mb =~ tr/A-Za-z/0/s;
-                       $mb =~ s/\b(\d)\b/0$1/g;
-                       while (length($ma) < length($mb)) { $ma .= ".00"; }
-                       while (length($mb) < length($ma)) { $mb .= ".00"; }
-                       # Comparison deliberately backwards
-                       $mb cmp $ma;} @fullname)[0];
-           } elsif (-f ($fullname="$thispth/lib$thislib.$so")
-                && (($Config{'dlsrc'} ne "dl_dld.xs") || ($thislib eq "m"))){
-           } elsif (-f ($fullname="$thispth/lib${thislib}_s$Config_libext")
-                 && (! $Config{'archname'} =~ /RM\d\d\d-svr4/)
-                && ($thislib .= "_s") ){ # we must explicitly use _s version
-           } elsif (-f ($fullname="$thispth/lib$thislib$Config_libext")){
-           } elsif (-f ($fullname="$thispth/$thislib$Config_libext")){
-           } elsif (-f ($fullname="$thispth/Slib$thislib$Config_libext")){
-           } elsif ($^O eq 'dgux'
-                && -l ($fullname="$thispth/lib$thislib$Config_libext")
-                && readlink($fullname) =~ /^elink:/s) {
-                # Some of DG's libraries look like misconnected symbolic
-                # links, but development tools can follow them.  (They
-                # look like this:
-                #
-                #    libm.a -> elink:${SDE_PATH:-/usr}/sde/\
-                #    ${TARGET_BINARY_INTERFACE:-m88kdgux}/usr/lib/libm.a
-                #
-                # , the compilation tools expand the environment variables.)
-           } else {
-               warn "$thislib not found in $thispth\n" if $verbose;
-               next;
-           }
-           warn "'-l$thislib' found at $fullname\n" if $verbose;
-           my($fullnamedir) = dirname($fullname);
-           push @ld_run_path, $fullnamedir unless $ld_run_path_seen{$fullnamedir}++;
-           push @libs, $fullname unless $libs_seen{$fullname}++;
-           $found++;
-           $found_lib++;
-
-           # Now update library lists
-
-           # what do we know about this library...
-           my $is_dyna = ($fullname !~ /\Q$Config_libext\E\z/);
-           my $in_perl = ($libs =~ /\B-l\Q$ {thislib}\E\b/s);
-
-           # Do not add it into the list if it is already linked in
-           # with the main perl executable.
-           # We have to special-case the NeXT, because math and ndbm 
-           # are both in libsys_s
-           unless ($in_perl || 
-               ($Config{'osname'} eq 'next' &&
-                   ($thislib eq 'm' || $thislib eq 'ndbm')) ){
-               push(@extralibs, "-l$thislib");
-           }
-
-           # We might be able to load this archive file dynamically
-           if ( ($Config{'dlsrc'} =~ /dl_next/ && $Config{'osvers'} lt '4_0')
-           ||   ($Config{'dlsrc'} =~ /dl_dld/) )
-           {
-               # We push -l$thislib instead of $fullname because
-               # it avoids hardwiring a fixed path into the .bs file.
-               # Mkbootstrap will automatically add dl_findfile() to
-               # the .bs file if it sees a name in the -l format.
-               # USE THIS, when dl_findfile() is fixed: 
-               # push(@bsloadlibs, "-l$thislib");
-               # OLD USE WAS while checking results against old_extliblist
-               push(@bsloadlibs, "$fullname");
-           } else {
-               if ($is_dyna){
-                    # For SunOS4, do not add in this shared library if
-                    # it is already linked in the main perl executable
-                   push(@ldloadlibs, "-l$thislib")
-                       unless ($in_perl and $^O eq 'sunos');
-               } else {
-                   push(@ldloadlibs, "-l$thislib");
-               }
-           }
-           last;       # found one here so don't bother looking further
-       }
-       warn "Note (probably harmless): "
-                    ."No library found for -l$thislib\n"
-           unless $found_lib>0;
-    }
-    return ('','','','', ($give_libs ? \@libs : ())) unless $found;
-    ("@extralibs", "@bsloadlibs", "@ldloadlibs",join(":",@ld_run_path), ($give_libs ? \@libs : ()));
-}
-
-sub _win32_ext {
-
-    require Text::ParseWords;
-
-    my($self, $potential_libs, $verbose, $give_libs) = @_;
-
-    # If user did not supply a list, we punt.
-    # (caller should probably use the list in $Config{libs})
-    return ("", "", "", "", ($give_libs ? [] : ())) unless $potential_libs;
-
-    my $cc             = $Config{cc};
-    my $VC             = 1 if $cc =~ /^cl/i;
-    my $BC             = 1 if $cc =~ /^bcc/i;
-    my $GC             = 1 if $cc =~ /^gcc/i;
-    my $so             = $Config{'so'};
-    my $libs           = $Config{'perllibs'};
-    my $libpth         = $Config{'libpth'};
-    my $libext         = $Config{'lib_ext'} || ".lib";
-    my(@libs, %libs_seen);
-
-    if ($libs and $potential_libs !~ /:nodefault/i) { 
-       # If Config.pm defines a set of default libs, we always
-       # tack them on to the user-supplied list, unless the user
-       # specified :nodefault
-
-       $potential_libs .= " " if $potential_libs;
-       $potential_libs .= $libs;
-    }
-    warn "Potential libraries are '$potential_libs':\n" if $verbose;
-
-    # normalize to forward slashes
-    $libpth =~ s,\\,/,g;
-    $potential_libs =~ s,\\,/,g;
-
-    # compute $extralibs from $potential_libs
-
-    my @searchpath;                # from "-L/path" in $potential_libs
-    my @libpath                = Text::ParseWords::quotewords('\s+', 0, $libpth);
-    my @extralibs;
-    my $pwd            = cwd();    # from Cwd.pm
-    my $lib            = '';
-    my $found          = 0;
-    my $search         = 1;
-    my($fullname, $thislib, $thispth);
-
-    # add "$Config{installarchlib}/CORE" to default search path
-    push @libpath, "$Config{installarchlib}/CORE";
-
-    if ($VC and exists $ENV{LIB} and $ENV{LIB}) {
-        push @libpath, split /;/, $ENV{LIB};
-    }
-
-    foreach (Text::ParseWords::quotewords('\s+', 0, $potential_libs)){
-
-       $thislib = $_;
-
-        # see if entry is a flag
-       if (/^:\w+$/) {
-           $search     = 0 if lc eq ':nosearch';
-           $search     = 1 if lc eq ':search';
-           warn "Ignoring unknown flag '$thislib'\n"
-               if $verbose and !/^:(no)?(search|default)$/i;
-           next;
-       }
-
-       # if searching is disabled, do compiler-specific translations
-       unless ($search) {
-           s/^-l(.+)$/$1.lib/ unless $GC;
-           s/^-L/-libpath:/ if $VC;
-           push(@extralibs, $_);
-           $found++;
-           next;
-       }
-
-       # handle possible linker path arguments
-       if (s/^-L// and not -d) {
-           warn "$thislib ignored, directory does not exist\n"
-               if $verbose;
-           next;
-       }
-       elsif (-d) {
-           unless ($self->file_name_is_absolute($_)) {
-             warn "Warning: '$thislib' changed to '-L$pwd/$_'\n";
-             $_ = $self->catdir($pwd,$_);
-           }
-           push(@searchpath, $_);
-           next;
-       }
-
-       # handle possible library arguments
-       if (s/^-l// and $GC and !/^lib/i) {
-           $_ = "lib$_";
-       }
-       $_ .= $libext if !/\Q$libext\E$/i;
-
-       my $secondpass = 0;
-    LOOKAGAIN:
-
-        # look for the file itself
-       if (-f) {
-           warn "'$thislib' found as '$_'\n" if $verbose;
-           $found++;
-           push(@extralibs, $_);
-           next;
-       }
-
-       my $found_lib = 0;
-       foreach $thispth (@searchpath, @libpath){
-           unless (-f ($fullname="$thispth\\$_")) {
-               warn "'$thislib' not found as '$fullname'\n" if $verbose;
-               next;
-           }
-           warn "'$thislib' found as '$fullname'\n" if $verbose;
-           $found++;
-           $found_lib++;
-           push(@extralibs, $fullname);
-           push @libs, $fullname unless $libs_seen{$fullname}++;
-           last;
-       }
-
-       # do another pass with (or without) leading 'lib' if they used -l
-       if (!$found_lib and $thislib =~ /^-l/ and !$secondpass++) {
-           if ($GC) {
-               goto LOOKAGAIN if s/^lib//i;
-           }
-           elsif (!/^lib/i) {
-               $_ = "lib$_";
-               goto LOOKAGAIN;
-           }
-       }
-
-       # give up
-       warn "Note (probably harmless): "
-                    ."No library found for '$thislib'\n"
-           unless $found_lib>0;
-
-    }
-
-    return ('','','','', ($give_libs ? \@libs : ())) unless $found;
-
-    # make sure paths with spaces are properly quoted
-    @extralibs = map { (/\s/ && !/^".*"$/) ? qq["$_"] : $_ } @extralibs;
-    @libs = map { (/\s/ && !/^".*"$/) ? qq["$_"] : $_ } @libs;
-    $lib = join(' ',@extralibs);
-
-    # normalize back to backward slashes (to help braindead tools)
-    # XXX this may break equally braindead GNU tools that don't understand
-    # backslashes, either.  Seems like one can't win here.  Cursed be CP/M.
-    $lib =~ s,/,\\,g;
-
-    warn "Result: $lib\n" if $verbose;
-    wantarray ? ($lib, '', $lib, '', ($give_libs ? \@libs : ())) : $lib;
+    goto &ExtUtils::Liblist::Kid::ext;
 }
 
-
-sub _vms_ext {
-  my($self, $potential_libs,$verbose,$give_libs) = @_;
-  my(@crtls,$crtlstr);
-  my($dbgqual) = $self->{OPTIMIZE} || $Config{'optimize'} ||
-                 $self->{CCFLAS}   || $Config{'ccflags'};
-  @crtls = ( ($dbgqual =~ m-/Debug-i ? $Config{'dbgprefix'} : '')
-              . 'PerlShr/Share' );
-  push(@crtls, grep { not /\(/ } split /\s+/, $Config{'perllibs'});
-  push(@crtls, grep { not /\(/ } split /\s+/, $Config{'libc'});
-  # In general, we pass through the basic libraries from %Config unchanged.
-  # The one exception is that if we're building in the Perl source tree, and
-  # a library spec could be resolved via a logical name, we go to some trouble
-  # to insure that the copy in the local tree is used, rather than one to
-  # which a system-wide logical may point.
-  if ($self->{PERL_SRC}) {
-    my($lib,$locspec,$type);
-    foreach $lib (@crtls) { 
-      if (($locspec,$type) = $lib =~ m-^([\w$\-]+)(/\w+)?- and $locspec =~ /perl/i) {
-        if    (lc $type eq '/share')   { $locspec .= $Config{'exe_ext'}; }
-        elsif (lc $type eq '/library') { $locspec .= $Config{'lib_ext'}; }
-        else                           { $locspec .= $Config{'obj_ext'}; }
-        $locspec = $self->catfile($self->{PERL_SRC},$locspec);
-        $lib = "$locspec$type" if -e $locspec;
-      }
-    }
-  }
-  $crtlstr = @crtls ? join(' ',@crtls) : '';
-
-  unless ($potential_libs) {
-    warn "Result:\n\tEXTRALIBS: \n\tLDLOADLIBS: $crtlstr\n" if $verbose;
-    return ('', '', $crtlstr, '', ($give_libs ? [] : ()));
-  }
-
-  my(@dirs,@libs,$dir,$lib,%found,@fndlibs,$ldlib);
-  my $cwd = cwd();
-  my($so,$lib_ext,$obj_ext) = @Config{'so','lib_ext','obj_ext'};
-  # List of common Unix library names and there VMS equivalents
-  # (VMS equivalent of '' indicates that the library is automatially
-  # searched by the linker, and should be skipped here.)
-  my(@flibs, %libs_seen);
-  my %libmap = ( 'm' => '', 'f77' => '', 'F77' => '', 'V77' => '', 'c' => '',
-                 'malloc' => '', 'crypt' => '', 'resolv' => '', 'c_s' => '',
-                 'socket' => '', 'X11' => 'DECW$XLIBSHR',
-                 'Xt' => 'DECW$XTSHR', 'Xm' => 'DECW$XMLIBSHR',
-                 'Xmu' => 'DECW$XMULIBSHR');
-  if ($Config{'vms_cc_type'} ne 'decc') { $libmap{'curses'} = 'VAXCCURSE'; }
-
-  warn "Potential libraries are '$potential_libs'\n" if $verbose;
-
-  # First, sort out directories and library names in the input
-  foreach $lib (split ' ',$potential_libs) {
-    push(@dirs,$1),   next if $lib =~ /^-L(.*)/;
-    push(@dirs,$lib), next if $lib =~ /[:>\]]$/;
-    push(@dirs,$lib), next if -d $lib;
-    push(@libs,$1),   next if $lib =~ /^-l(.*)/;
-    push(@libs,$lib);
-  }
-  push(@dirs,split(' ',$Config{'libpth'}));
-
-  # Now make sure we've got VMS-syntax absolute directory specs
-  # (We don't, however, check whether someone's hidden a relative
-  # path in a logical name.)
-  foreach $dir (@dirs) {
-    unless (-d $dir) {
-      warn "Skipping nonexistent Directory $dir\n" if $verbose > 1;
-      $dir = '';
-      next;
-    }
-    warn "Resolving directory $dir\n" if $verbose;
-    if ($self->file_name_is_absolute($dir)) { $dir = $self->fixpath($dir,1); }
-    else                                    { $dir = $self->catdir($cwd,$dir); }
-  }
-  @dirs = grep { length($_) } @dirs;
-  unshift(@dirs,''); # Check each $lib without additions first
-
-  LIB: foreach $lib (@libs) {
-    if (exists $libmap{$lib}) {
-      next unless length $libmap{$lib};
-      $lib = $libmap{$lib};
-    }
-
-    my(@variants,$variant,$name,$test,$cand);
-    my($ctype) = '';
-
-    # If we don't have a file type, consider it a possibly abbreviated name and
-    # check for common variants.  We try these first to grab libraries before
-    # a like-named executable image (e.g. -lperl resolves to perlshr.exe
-    # before perl.exe).
-    if ($lib !~ /\.[^:>\]]*$/) {
-      push(@variants,"${lib}shr","${lib}rtl","${lib}lib");
-      push(@variants,"lib$lib") if $lib !~ /[:>\]]/;
-    }
-    push(@variants,$lib);
-    warn "Looking for $lib\n" if $verbose;
-    foreach $variant (@variants) {
-      foreach $dir (@dirs) {
-        my($type);
-
-        $name = "$dir$variant";
-        warn "\tChecking $name\n" if $verbose > 2;
-        if (-f ($test = VMS::Filespec::rmsexpand($name))) {
-          # It's got its own suffix, so we'll have to figure out the type
-          if    ($test =~ /(?:$so|exe)$/i)      { $type = 'SHR'; }
-          elsif ($test =~ /(?:$lib_ext|olb)$/i) { $type = 'OLB'; }
-          elsif ($test =~ /(?:$obj_ext|obj)$/i) {
-            warn "Note (probably harmless): "
-                        ."Plain object file $test found in library list\n";
-            $type = 'OBJ';
-          }
-          else {
-            warn "Note (probably harmless): "
-                        ."Unknown library type for $test; assuming shared\n";
-            $type = 'SHR';
-          }
-        }
-        elsif (-f ($test = VMS::Filespec::rmsexpand($name,$so))      or
-               -f ($test = VMS::Filespec::rmsexpand($name,'.exe')))     {
-          $type = 'SHR';
-          $name = $test unless $test =~ /exe;?\d*$/i;
-        }
-        elsif (not length($ctype) and  # If we've got a lib already, don't bother
-               ( -f ($test = VMS::Filespec::rmsexpand($name,$lib_ext)) or
-                 -f ($test = VMS::Filespec::rmsexpand($name,'.olb'))))  {
-          $type = 'OLB';
-          $name = $test unless $test =~ /olb;?\d*$/i;
-        }
-        elsif (not length($ctype) and  # If we've got a lib already, don't bother
-               ( -f ($test = VMS::Filespec::rmsexpand($name,$obj_ext)) or
-                 -f ($test = VMS::Filespec::rmsexpand($name,'.obj'))))  {
-          warn "Note (probably harmless): "
-                      ."Plain object file $test found in library list\n";
-          $type = 'OBJ';
-          $name = $test unless $test =~ /obj;?\d*$/i;
-        }
-        if (defined $type) {
-          $ctype = $type; $cand = $name;
-          last if $ctype eq 'SHR';
-        }
-      }
-      if ($ctype) { 
-        # This has to precede any other CRTLs, so just make it first
-        if ($cand eq 'VAXCCURSE') { unshift @{$found{$ctype}}, $cand; }  
-        else                      { push    @{$found{$ctype}}, $cand; }
-        warn "\tFound as $cand (really $test), type $ctype\n" if $verbose > 1;
-       push @flibs, $name unless $libs_seen{$fullname}++;
-        next LIB;
-      }
-    }
-    warn "Note (probably harmless): "
-                ."No library found for $lib\n";
-  }
-
-  push @fndlibs, @{$found{OBJ}}                      if exists $found{OBJ};
-  push @fndlibs, map { "$_/Library" } @{$found{OLB}} if exists $found{OLB};
-  push @fndlibs, map { "$_/Share"   } @{$found{SHR}} if exists $found{SHR};
-  $lib = join(' ',@fndlibs);
-
-  $ldlib = $crtlstr ? "$lib $crtlstr" : $lib;
-  warn "Result:\n\tEXTRALIBS: $lib\n\tLDLOADLIBS: $ldlib\n" if $verbose;
-  wantarray ? ($lib, '', $ldlib, '', ($give_libs ? \@flibs : ())) : $lib;
+sub lsdir {
+  shift;
+  my $rex = qr/$_[1]/;
+  opendir DIR, $_[0];
+  my @out = grep /$rex/, readdir DIR;
+  closedir DIR;
+  return @out;
 }
 
-1;
-
 __END__
 
 =head1 NAME
@@ -533,9 +31,12 @@ ExtUtils::Liblist - determine libraries to use and how to use them
 
 =head1 SYNOPSIS
 
-C<require ExtUtils::Liblist;>
+  require ExtUtils::Liblist;
+
+  $MM->ext($potential_libs, $verbose, $need_names);
 
-C<ExtUtils::Liblist::ext($self, $potential_libs, $verbose, $need_names);>
+  # Usually you can get away with:
+  ExtUtils::Liblist->ext($potential_libs, $verbose, $need_names)
 
 =head1 DESCRIPTION
 
@@ -561,12 +62,12 @@ Dependent libraries can be linked in one of three ways:
 by the ld command when the perl binary is linked with the extension
 library. See EXTRALIBS below.
 
-=item * For dynamic extensions
+=item * For dynamic extensions at build/link time
 
 by the ld command when the shared object is built/linked. See
 LDLOADLIBS below.
 
-=item * For dynamic extensions
+=item * For dynamic extensions at load time
 
 by the DynaLoader when the shared object is loaded. See BSLOADLIBS
 below.