lib/ExtUtils/MM_Win32.pm

   1 package ExtUtils::MM_Win32;
   2
   3
   4 =head1 NAME
   5
   6 ExtUtils::MM_Win32 - methods to override UN*X behaviour in ExtUtils::MakeMaker
   7
   8 =head1 SYNOPSIS
   9
  10  use ExtUtils::MM_Win32; # Done internally by ExtUtils::MakeMaker if needed
  11
  12 =head1 DESCRIPTION
  13
  14 See ExtUtils::MM_Unix for a documentation of the methods provided
  15 there. This package overrides the implementation of these methods, not
  16 the semantics.
  17
  18 =over 4
  19
  20 =cut
  21
  22 use Config;
  23 use File::Basename;
  24 use File::Spec;
  25 use ExtUtils::MakeMaker qw( neatvalue );
  26
  27 use vars qw(@ISA $VERSION $BORLAND $GCC $DMAKE $NMAKE $PERLMAKE);
  28
  29 require ExtUtils::MM_Any;
  30 require ExtUtils::MM_Unix;
  31 @ISA = qw( ExtUtils::MM_Any ExtUtils::MM_Unix );
  32 $VERSION = '1.04_01';
  33
  34 $ENV{EMXSHELL} = 'sh'; # to run `commands`
  35
  36 $BORLAND = 1 if $Config{'cc'} =~ /^bcc/i;
  37 $GCC     = 1 if $Config{'cc'} =~ /^gcc/i;
  38 $DMAKE = 1 if $Config{'make'} =~ /^dmake/i;
  39 $NMAKE = 1 if $Config{'make'} =~ /^nmake/i;
  40 $PERLMAKE = 1 if $Config{'make'} =~ /^pmake/i;
  41
  42 sub dlsyms {
  43     my($self,%attribs) = @_;
  44
  45     my($funcs) = $attribs{DL_FUNCS} || $self->{DL_FUNCS} || {};
  46     my($vars)  = $attribs{DL_VARS} || $self->{DL_VARS} || [];
  47     my($funclist) = $attribs{FUNCLIST} || $self->{FUNCLIST} || [];
  48     my($imports)  = $attribs{IMPORTS} || $self->{IMPORTS} || {};
  49     my(@m);
  50     (my $boot = $self->{NAME}) =~ s/:/_/g;
  51
  52     if (not $self->{SKIPHASH}{'dynamic'}) {
  53         push(@m,"
  54 $self->{BASEEXT}.def: Makefile.PL
  55 ",
  56      q! $(PERLRUN) -MExtUtils::Mksymlists \\
  57      -e "Mksymlists('NAME'=>\"!, $self->{NAME},
  58      q!\", 'DLBASE' => '!,$self->{DLBASE},
  59      # The above two lines quoted differently to work around
  60      # a bug in the 4DOS/4NT command line interpreter.  The visible
  61      # result of the bug was files named q('extension_name',) *with the
  62      # single quotes and the comma* in the extension build directories.
  63      q!', 'DL_FUNCS' => !,neatvalue($funcs),
  64      q!, 'FUNCLIST' => !,neatvalue($funclist),
  65      q!, 'IMPORTS' => !,neatvalue($imports),
  66      q!, 'DL_VARS' => !, neatvalue($vars), q!);"
  67 !);
  68     }
  69     join('',@m);
  70 }
  71
  72 sub replace_manpage_separator {
  73     my($self,$man) = @_;
  74     $man =~ s,/+,.,g;
  75     $man;
  76 }
  77
  78 sub maybe_command {
  79     my($self,$file) = @_;
  80     my @e = exists($ENV{'PATHEXT'})
  81           ? split(/;/, $ENV{PATHEXT})
  82           : qw(.com .exe .bat .cmd);
  83     my $e = '';
  84     for (@e) { $e .= "\Q$_\E|" }
  85     chop $e;
  86     # see if file ends in one of the known extensions
  87     if ($file =~ /($e)$/i) {
  88         return $file if -e $file;
  89     }
  90     else {
  91         for (@e) {
  92             return "$file$_" if -e "$file$_";
  93         }
  94     }
  95     return;
  96 }
  97
  98
  99 sub find_perl {
 100     my($self, $ver, $names, $dirs, $trace) = @_;
 101     $trace ||= 0;
 102
 103     my($name, $dir);
 104     if ($trace >= 2){
 105         print "Looking for perl $ver by these names:
 106 @$names
 107 in these dirs:
 108 @$dirs
 109 ";
 110     }
 111     foreach $dir (@$dirs){
 112         next unless defined $dir; # $self->{PERL_SRC} may be undefined
 113         foreach $name (@$names){
 114             my ($abs, $val);
 115             if (File::Spec->file_name_is_absolute($name)) {  # /foo/bar
 116                 $abs = $name;
 117             } elsif (File::Spec->canonpath($name) eq
 118                      File::Spec->canonpath(basename($name))) # foo
 119             {
 120                 $abs = File::Spec->catfile($dir, $name);
 121             } else {                                         # foo/bar
 122                 $abs = File::Spec->canonpath(
 123                            File::Spec->catfile(File::Spec->curdir, $name)
 124                        );
 125             }
 126             print "Checking $abs\n" if ($trace >= 2);
 127             next unless $self->maybe_command($abs);
 128             print "Executing $abs\n" if ($trace >= 2);
 129             (my($safe_abs) = $abs) =~ s{(\s)}{\\$1}g;
 130             $val = `$safe_abs -e "require $ver;" 2>&1`;
 131             if ($? == 0) {
 132                 print "Using PERL=$abs\n" if $trace;
 133                 return $abs;
 134             } elsif ($trace >= 2) {
 135                 print "Result: `$val'\n";
 136             }
 137         }
 138     }
 139     print STDOUT "Unable to find a perl $ver (by these names: @$names, in these dirs: @$dirs)\n";
 140     0; # false and not empty
 141 }
 142
 143 sub init_others
 144 {
 145  my ($self) = @_;
 146  $self->SUPER::init_others;
 147  $self->{'TOUCH'}  = '$(PERLRUN) -MExtUtils::Command -e touch';
 148  $self->{'CHMOD'}  = '$(PERLRUN) -MExtUtils::Command -e chmod';
 149  $self->{'CP'}     = '$(PERLRUN) -MExtUtils::Command -e cp';
 150  $self->{'RM_F'}   = '$(PERLRUN) -MExtUtils::Command -e rm_f';
 151  $self->{'RM_RF'}  = '$(PERLRUN) -MExtUtils::Command -e rm_rf';
 152  $self->{'MV'}     = '$(PERLRUN) -MExtUtils::Command -e mv';
 153  $self->{'NOOP'}   = 'rem';
 154  $self->{'TEST_F'} = '$(PERLRUN) -MExtUtils::Command -e test_f';
 155  $self->{'LD'}     = $Config{'ld'} || 'link';
 156  $self->{'AR'}     = $Config{'ar'} || 'lib';
 157  $self->{'LDLOADLIBS'} ||= $Config{'libs'};
 158  # -Lfoo must come first for Borland, so we put it in LDDLFLAGS
 159  if ($BORLAND) {
 160      my $libs = $self->{'LDLOADLIBS'};
 161      my $libpath = '';
 162      while ($libs =~ s/(?:^|\s)(("?)-L.+?\2)(?:\s|$)/ /) {
 163          $libpath .= ' ' if length $libpath;
 164          $libpath .= $1;
 165      }
 166      $self->{'LDLOADLIBS'} = $libs;
 167      $self->{'LDDLFLAGS'} ||= $Config{'lddlflags'};
 168      $self->{'LDDLFLAGS'} .= " $libpath";
 169  }
 170  $self->{'DEV_NULL'} = '> NUL';
 171 }
 172
 173
 174 =item constants (o)
 175
 176 Initializes lots of constants and .SUFFIXES and .PHONY
 177
 178 =cut
 179
 180 sub constants {
 181     my($self) = @_;
 182     my(@m,$tmp);
 183
 184     for $tmp (qw/
 185
 186               AR_STATIC_ARGS NAME DISTNAME NAME_SYM VERSION
 187               VERSION_SYM XS_VERSION INST_BIN INST_EXE INST_LIB
 188               INST_ARCHLIB INST_SCRIPT PREFIX  INSTALLDIRS
 189               INSTALLPRIVLIB INSTALLARCHLIB INSTALLSITELIB
 190               INSTALLSITEARCH INSTALLBIN INSTALLSCRIPT PERL_LIB
 191               PERL_ARCHLIB SITELIBEXP SITEARCHEXP LIBPERL_A MYEXTLIB
 192               FIRST_MAKEFILE MAKE_APERL_FILE PERLMAINCC PERL_SRC
 193               PERL_INC PERL FULLPERL PERLRUN FULLPERLRUN PERLRUNINST
 194           FULLPERLRUNINST TEST_LIBS FULL_AR PERL_CORE
 195
 196               / ) {
 197         next unless defined $self->{$tmp};
 198         push @m, "$tmp = $self->{$tmp}\n";
 199     }
 200
 201     push @m, qq{
 202 VERSION_MACRO = VERSION
 203 DEFINE_VERSION = -D\$(VERSION_MACRO)=\\\"\$(VERSION)\\\"
 204 XS_VERSION_MACRO = XS_VERSION
 205 XS_DEFINE_VERSION = -D\$(XS_VERSION_MACRO)=\\\"\$(XS_VERSION)\\\"
 206 };
 207
 208     push @m, qq{
 209 MAKEMAKER = $INC{'ExtUtils/MakeMaker.pm'}
 210 MM_VERSION = $ExtUtils::MakeMaker::VERSION
 211 };
 212
 213     push @m, q{
 214 # FULLEXT = Pathname for extension directory (eg Foo/Bar/Oracle).
 215 # BASEEXT = Basename part of FULLEXT. May be just equal FULLEXT. (eg Oracle)
 216 # PARENT_NAME = NAME without BASEEXT and no trailing :: (eg Foo::Bar)
 217 # DLBASE  = Basename part of dynamic library. May be just equal BASEEXT.
 218 };
 219
 220     for $tmp (qw/
 221               FULLEXT BASEEXT PARENT_NAME DLBASE VERSION_FROM INC DEFINE OBJECT
 222               LDFROM LINKTYPE
 223               / ) {
 224         next unless defined $self->{$tmp};
 225         push @m, "$tmp = $self->{$tmp}\n";
 226     }
 227
 228     push @m, "
 229 # Handy lists of source code files:
 230 XS_FILES= ".join(" \\\n\t", sort keys %{$self->{XS}})."
 231 C_FILES = ".join(" \\\n\t", @{$self->{C}})."
 232 O_FILES = ".join(" \\\n\t", @{$self->{O_FILES}})."
 233 H_FILES = ".join(" \\\n\t", @{$self->{H}})."
 234 MAN1PODS = ".join(" \\\n\t", sort keys %{$self->{MAN1PODS}})."
 235 MAN3PODS = ".join(" \\\n\t", sort keys %{$self->{MAN3PODS}})."
 236 ";
 237
 238     for $tmp (qw/
 239               INST_MAN1DIR        INSTALLMAN1DIR MAN1EXT
 240               INST_MAN3DIR        INSTALLMAN3DIR MAN3EXT
 241               /) {
 242         next unless defined $self->{$tmp};
 243         push @m, "$tmp = $self->{$tmp}\n";
 244     }
 245
 246     push @m, qq{
 247 .USESHELL :
 248 } if $DMAKE;
 249
 250     push @m, q{
 251 .NO_CONFIG_REC: Makefile
 252 } if $ENV{CLEARCASE_ROOT};
 253
 254     # why not q{} ? -- emacs
 255     push @m, qq{
 256 # work around a famous dec-osf make(1) feature(?):
 257 makemakerdflt: all
 258
 259 .SUFFIXES: .xs .c .C .cpp .cxx .cc \$(OBJ_EXT)
 260
 261 # Nick wanted to get rid of .PRECIOUS. I don't remember why. I seem to
 262 # recall, that some make implementations will delete the Makefile when we
 263 # rebuild it. Because we call false(1) when we rebuild it. So make(1) is
 264 # not completely wrong when it does so. Our milage may vary.
 265 # .PRECIOUS: Makefile    # seems to be not necessary anymore
 266
 267 .PHONY: all config static dynamic test linkext manifest
 268
 269 # Where is the Config information that we are using/depend on
 270 CONFIGDEP = \$(PERL_ARCHLIB)\\Config.pm \$(PERL_INC)\\config.h
 271 };
 272
 273     my @parentdir = split(/::/, $self->{PARENT_NAME});
 274     push @m, q{
 275 # Where to put things:
 276 INST_LIBDIR      = }. File::Spec->catdir('$(INST_LIB)',@parentdir)        .q{
 277 INST_ARCHLIBDIR  = }. File::Spec->catdir('$(INST_ARCHLIB)',@parentdir)    .q{
 278
 279 INST_AUTODIR     = }. File::Spec->catdir('$(INST_LIB)','auto','$(FULLEXT)')       .q{
 280 INST_ARCHAUTODIR = }. File::Spec->catdir('$(INST_ARCHLIB)','auto','$(FULLEXT)')   .q{
 281 };
 282
 283     if ($self->has_link_code()) {
 284         push @m, '
 285 INST_STATIC  = $(INST_ARCHAUTODIR)\$(BASEEXT)$(LIB_EXT)
 286 INST_DYNAMIC = $(INST_ARCHAUTODIR)\$(DLBASE).$(DLEXT)
 287 INST_BOOT    = $(INST_ARCHAUTODIR)\$(BASEEXT).bs
 288 ';
 289     } else {
 290         push @m, '
 291 INST_STATIC  =
 292 INST_DYNAMIC =
 293 INST_BOOT    =
 294 ';
 295     }
 296
 297     $tmp = $self->export_list;
 298     push @m, "
 299 EXPORT_LIST = $tmp
 300 ";
 301     $tmp = $self->perl_archive;
 302     push @m, "
 303 PERL_ARCHIVE = $tmp
 304 ";
 305
 306     push @m, q{
 307 TO_INST_PM = }.join(" \\\n\t", sort keys %{$self->{PM}}).q{
 308
 309 PM_TO_BLIB = }.join(" \\\n\t", %{$self->{PM}}).q{
 310 };
 311
 312     join('',@m);
 313 }
 314
 315
 316 =item static_lib (o)
 317
 318 Defines how to produce the *.a (or equivalent) files.
 319
 320 =cut
 321
 322 sub static_lib {
 323     my($self) = @_;
 324 # Come to think of it, if there are subdirs with linkcode, we still have no INST_STATIC
 325 #    return '' unless $self->needs_linking(); #might be because of a subdir
 326
 327     return '' unless $self->has_link_code;
 328
 329     my(@m);
 330     push(@m, <<'END');
 331 $(INST_STATIC): $(OBJECT) $(MYEXTLIB) $(INST_ARCHAUTODIR)\.exists
 332         $(RM_RF) $@
 333 END
 334     # If this extension has its own library (eg SDBM_File)
 335     # then copy that to $(INST_STATIC) and add $(OBJECT) into it.
 336     push(@m, "\t$self->{CP} \$(MYEXTLIB) \$\@\n") if $self->{MYEXTLIB};
 337
 338     push @m,
 339 q{      $(AR) }.($BORLAND ? '$@ $(OBJECT:^"+")'
 340                           : ($GCC ? '-ru $@ $(OBJECT)'
 341                                   : '-out:$@ $(OBJECT)')).q{
 342         }.$self->{NOECHO}.q{echo "$(EXTRALIBS)" > $(INST_ARCHAUTODIR)\extralibs.ld
 343         $(CHMOD) 755 $@
 344 };
 345
 346 # Old mechanism - still available:
 347
 348     push @m, "\t$self->{NOECHO}".q{echo "$(EXTRALIBS)" >> $(PERL_SRC)\ext.libs}."\n\n"
 349         if $self->{PERL_SRC};
 350
 351     push @m, $self->dir_target('$(INST_ARCHAUTODIR)');
 352     join('', "\n",@m);
 353 }
 354
 355 =item dynamic_bs (o)
 356
 357 Defines targets for bootstrap files.
 358
 359 =cut
 360
 361 sub dynamic_bs {
 362     my($self, %attribs) = @_;
 363     return '
 364 BOOTSTRAP =
 365 ' unless $self->has_link_code();
 366
 367     return '
 368 BOOTSTRAP = '."$self->{BASEEXT}.bs".'
 369
 370 # As Mkbootstrap might not write a file (if none is required)
 371 # we use touch to prevent make continually trying to remake it.
 372 # The DynaLoader only reads a non-empty file.
 373 $(BOOTSTRAP): '."$self->{MAKEFILE} $self->{BOOTDEP}".' $(INST_ARCHAUTODIR)\.exists
 374         '.$self->{NOECHO}.'echo "Running Mkbootstrap for $(NAME) ($(BSLOADLIBS))"
 375         '.$self->{NOECHO}.'$(PERLRUN) \
 376                 -MExtUtils::Mkbootstrap \
 377                 -e "Mkbootstrap(\'$(BASEEXT)\',\'$(BSLOADLIBS)\');"
 378         '.$self->{NOECHO}.'$(TOUCH) $(BOOTSTRAP)
 379         $(CHMOD) 644 $@
 380
 381 $(INST_BOOT): $(BOOTSTRAP) $(INST_ARCHAUTODIR)\.exists
 382         '."$self->{NOECHO}$self->{RM_RF}".' $(INST_BOOT)
 383         -'.$self->{CP}.' $(BOOTSTRAP) $(INST_BOOT)
 384         $(CHMOD) 644 $@
 385 ';
 386 }
 387
 388 =item dynamic_lib (o)
 389
 390 Defines how to produce the *.so (or equivalent) files.
 391
 392 =cut
 393
 394 sub dynamic_lib {
 395     my($self, %attribs) = @_;
 396     return '' unless $self->needs_linking(); #might be because of a subdir
 397
 398     return '' unless $self->has_link_code;
 399
 400     my($otherldflags) = $attribs{OTHERLDFLAGS} || ($BORLAND ? 'c0d32.obj': '');
 401     my($inst_dynamic_dep) = $attribs{INST_DYNAMIC_DEP} || "";
 402     my($ldfrom) = '$(LDFROM)';
 403     my(@m);
 404
 405 # one thing for GCC/Mingw32:
 406 # we try to overcome non-relocateable-DLL problems by generating
 407 #    a (hopefully unique) image-base from the dll's name
 408 # -- BKS, 10-19-1999
 409     if ($GCC) {
 410         my $dllname = $self->{BASEEXT} . "." . $self->{DLEXT};
 411         $dllname =~ /(....)(.{0,4})/;
 412         my $baseaddr = unpack("n", $1 ^ $2);
 413         $otherldflags .= sprintf("-Wl,--image-base,0x%x0000 ", $baseaddr);
 414     }
 415
 416     push(@m,'
 417 # This section creates the dynamically loadable $(INST_DYNAMIC)
 418 # from $(OBJECT) and possibly $(MYEXTLIB).
 419 OTHERLDFLAGS = '.$otherldflags.'
 420 INST_DYNAMIC_DEP = '.$inst_dynamic_dep.'
 421
 422 $(INST_DYNAMIC): $(OBJECT) $(MYEXTLIB) $(BOOTSTRAP) $(INST_ARCHAUTODIR)\.exists $(EXPORT_LIST) $(PERL_ARCHIVE) $(INST_DYNAMIC_DEP)
 423 ');
 424     if ($GCC) {
 425       push(@m,
 426        q{       dlltool --def $(EXPORT_LIST) --output-exp dll.exp
 427         $(LD) -o $@ -Wl,--base-file -Wl,dll.base $(LDDLFLAGS) }.$ldfrom.q{ $(OTHERLDFLAGS) $(MYEXTLIB) $(PERL_ARCHIVE) $(LDLOADLIBS) dll.exp
 428         dlltool --def $(EXPORT_LIST) --base-file dll.base --output-exp dll.exp
 429         $(LD) -o $@ $(LDDLFLAGS) }.$ldfrom.q{ $(OTHERLDFLAGS) $(MYEXTLIB) $(PERL_ARCHIVE) $(LDLOADLIBS) dll.exp });
 430     } elsif ($BORLAND) {
 431       push(@m,
 432        q{       $(LD) $(LDDLFLAGS) $(OTHERLDFLAGS) }.$ldfrom.q{,$@,,}
 433        .($DMAKE ? q{$(PERL_ARCHIVE:s,/,\,) $(LDLOADLIBS:s,/,\,) }
 434                  .q{$(MYEXTLIB:s,/,\,),$(EXPORT_LIST:s,/,\,)}
 435                 : q{$(subst /,\,$(PERL_ARCHIVE)) $(subst /,\,$(LDLOADLIBS)) }
 436                  .q{$(subst /,\,$(MYEXTLIB)),$(subst /,\,$(EXPORT_LIST))})
 437        .q{,$(RESFILES)});
 438     } else {    # VC
 439       push(@m,
 440        q{       $(LD) -out:$@ $(LDDLFLAGS) }.$ldfrom.q{ $(OTHERLDFLAGS) }
 441       .q{$(MYEXTLIB) $(PERL_ARCHIVE) $(LDLOADLIBS) -def:$(EXPORT_LIST)});
 442     }
 443     push @m, '
 444         $(CHMOD) 755 $@
 445 ';
 446
 447     push @m, $self->dir_target('$(INST_ARCHAUTODIR)');
 448     join('',@m);
 449 }
 450
 451 sub clean
 452 {
 453     my ($self) = shift;
 454     my $s = $self->SUPER::clean(@_);
 455     my $clean = $GCC ? 'dll.base dll.exp' : '*.pdb';
 456     $s .= <<END;
 457 clean ::
 458         -\$(RM_F) $clean
 459
 460 END
 461     return $s;
 462 }
 463
 464
 465
 466 sub perl_archive
 467 {
 468     my ($self) = @_;
 469     return '$(PERL_INC)\\'.$Config{'libperl'};
 470 }
 471
 472 sub export_list
 473 {
 474  my ($self) = @_;
 475  return "$self->{BASEEXT}.def";
 476 }
 477
 478 =item canonpath
 479
 480 No physical check on the filesystem, but a logical cleanup of a
 481 path. On UNIX eliminated successive slashes and successive "/.".
 482
 483 =cut
 484
 485 sub canonpath {
 486     my($self,$path) = @_;
 487     $path =~ s/^([a-z]:)/\u$1/;
 488     $path =~ s|/|\\|g;
 489     $path =~ s|(.)\\+|$1\\|g ;                     # xx////xx  -> xx/xx
 490     $path =~ s|(\\\.)+\\|\\|g ;                    # xx/././xx -> xx/xx
 491     $path =~ s|^(\.\\)+|| unless $path eq ".\\";   # ./xx      -> xx
 492     $path =~ s|\\$||
 493              unless $path =~ m#^([a-z]:)?\\#;      # xx/       -> xx
 494     $path .= '.' if $path =~ m#\\$#;
 495     $path;
 496 }
 497
 498 =item perl_script
 499
 500 Takes one argument, a file name, and returns the file name, if the
 501 argument is likely to be a perl script. On MM_Unix this is true for
 502 any ordinary, readable file.
 503
 504 =cut
 505
 506 sub perl_script {
 507     my($self,$file) = @_;
 508     return $file if -r $file && -f _;
 509     return "$file.pl" if -r "$file.pl" && -f _;
 510     return "$file.bat" if -r "$file.bat" && -f _;
 511     return;
 512 }
 513
 514 =item pm_to_blib
 515
 516 Defines target that copies all files in the hash PM to their
 517 destination and autosplits them. See L<ExtUtils::Install/DESCRIPTION>
 518
 519 =cut
 520
 521 sub pm_to_blib {
 522     my $self = shift;
 523     my($autodir) = File::Spec->catdir('$(INST_LIB)','auto');
 524     return q{
 525 pm_to_blib: $(TO_INST_PM)
 526         }.$self->{NOECHO}.q{$(PERLRUNINST) -MExtUtils::Install \
 527         -e "pm_to_blib(}.
 528         ($NMAKE ? 'qw[ <<pmfiles.dat ],'
 529                 : $DMAKE ? 'qw[ $(mktmp,pmfiles.dat $(PM_TO_BLIB:s,\\,\\\\,)\n) ],'
 530                          : '{ qw[$(PM_TO_BLIB)] },'
 531          ).q{'}.$autodir.q{','$(PM_FILTER)')"
 532         }. ($NMAKE ? q{
 533 $(PM_TO_BLIB)
 534 <<
 535         } : '') . $self->{NOECHO}.q{$(TOUCH) $@
 536 };
 537 }
 538
 539
 540 =item tool_autosplit (override)
 541
 542 Use Win32 quoting on command line.
 543
 544 =cut
 545
 546 sub tool_autosplit{
 547     my($self, %attribs) = @_;
 548     my($asl) = "";
 549     $asl = "\$AutoSplit::Maxlen=$attribs{MAXLEN};" if $attribs{MAXLEN};
 550     q{
 551 # Usage: $(AUTOSPLITFILE) FileToSplit AutoDirToSplitInto
 552 AUTOSPLITFILE = $(PERLRUN) -MAutoSplit }.$asl.q{ -e "autosplit($$ARGV[0], $$ARGV[1], 0, 1, 1);"
 553 };
 554 }
 555
 556 =item tools_other (o)
 557
 558 Win32 overrides.
 559
 560 Defines SHELL, LD, TOUCH, CP, MV, RM_F, RM_RF, CHMOD, UMASK_NULL in
 561 the Makefile. Also defines the perl programs MKPATH,
 562 WARN_IF_OLD_PACKLIST, MOD_INSTALL. DOC_INSTALL, and UNINSTALL.
 563
 564 =cut
 565
 566 sub tools_other {
 567     my($self) = shift;
 568     my @m;
 569     my $bin_sh = $Config{sh} || 'cmd /c';
 570     push @m, qq{
 571 SHELL = $bin_sh
 572 } unless $DMAKE;  # dmake determines its own shell
 573
 574     for (qw/ CHMOD CP LD MV NOOP RM_F RM_RF TEST_F TOUCH UMASK_NULL DEV_NULL/ ) {
 575         push @m, "$_ = $self->{$_}\n";
 576     }
 577
 578     push @m, q{
 579 # The following is a portable way to say mkdir -p
 580 # To see which directories are created, change the if 0 to if 1
 581 MKPATH = $(PERLRUN) -MExtUtils::Command -e mkpath
 582
 583 # This helps us to minimize the effect of the .exists files A yet
 584 # better solution would be to have a stable file in the perl
 585 # distribution with a timestamp of zero. But this solution doesn't
 586 # need any changes to the core distribution and works with older perls
 587 EQUALIZE_TIMESTAMP = $(PERLRUN) -MExtUtils::Command -e eqtime
 588 };
 589
 590
 591     return join "", @m if $self->{PARENT};
 592
 593     push @m, q{
 594 # Here we warn users that an old packlist file was found somewhere,
 595 # and that they should call some uninstall routine
 596 WARN_IF_OLD_PACKLIST = $(PERL) -lwe "exit unless -f $$ARGV[0];" \\
 597 -e "print 'WARNING: I have found an old package in';" \\
 598 -e "print '     ', $$ARGV[0], '.';" \\
 599 -e "print 'Please make sure the two installations are not conflicting';"
 600
 601 UNINST=0
 602 VERBINST=1
 603
 604 MOD_INSTALL = $(PERL) -I$(INST_LIB) -I$(PERL_LIB) -MExtUtils::Install \
 605 -e "install({ @ARGV },'$(VERBINST)',0,'$(UNINST)');"
 606
 607 DOC_INSTALL = $(PERL) -e "$$\=\"\n\n\";" \
 608 -e "print '=head2 ', scalar(localtime), ': C<', shift, '>', ' L<', $$arg=shift, '|', $$arg, '>';" \
 609 -e "print '=over 4';" \
 610 -e "while (defined($$key = shift) and defined($$val = shift)) { print '=item *';print 'C<', \"$$key: $$val\", '>'; }" \
 611 -e "print '=back';"
 612
 613 UNINSTALL =   $(PERL) -MExtUtils::Install \
 614 -e "uninstall($$ARGV[0],1,1); print \"\nUninstall is deprecated. Please check the";" \
 615 -e "print \" packlist above carefully.\n  There may be errors. Remove the\";" \
 616 -e "print \" appropriate files manually.\n  Sorry for the inconveniences.\n\""
 617 };
 618
 619     return join "", @m;
 620 }
 621
 622 =item xs_o (o)
 623
 624 Defines suffix rules to go from XS to object files directly. This is
 625 only intended for broken make implementations.
 626
 627 =cut
 628
 629 sub xs_o {      # many makes are too dumb to use xs_c then c_o
 630     my($self) = shift;
 631     return ''
 632 }
 633
 634 =item top_targets (o)
 635
 636 Defines the targets all, subdirs, config, and O_FILES
 637
 638 =cut
 639
 640 sub top_targets {
 641 # --- Target Sections ---
 642
 643     my($self) = shift;
 644     my(@m);
 645
 646     push @m, '
 647 all :: pure_all manifypods
 648         '.$self->{NOECHO}.'$(NOOP)
 649 '
 650           unless $self->{SKIPHASH}{'all'};
 651
 652     push @m, '
 653 pure_all :: config pm_to_blib subdirs linkext
 654         '.$self->{NOECHO}.'$(NOOP)
 655
 656 subdirs :: $(MYEXTLIB)
 657         '.$self->{NOECHO}.'$(NOOP)
 658
 659 config :: '.$self->{MAKEFILE}.' $(INST_LIBDIR)\.exists
 660         '.$self->{NOECHO}.'$(NOOP)
 661
 662 config :: $(INST_ARCHAUTODIR)\.exists
 663         '.$self->{NOECHO}.'$(NOOP)
 664
 665 config :: $(INST_AUTODIR)\.exists
 666         '.$self->{NOECHO}.'$(NOOP)
 667 ';
 668
 669     push @m, $self->dir_target(qw[$(INST_AUTODIR) $(INST_LIBDIR) $(INST_ARCHAUTODIR)]);
 670
 671     if (%{$self->{MAN1PODS}}) {
 672         push @m, qq[
 673 config :: \$(INST_MAN1DIR)\\.exists
 674         $self->{NOECHO}\$(NOOP)
 675
 676 ];
 677         push @m, $self->dir_target(qw[$(INST_MAN1DIR)]);
 678     }
 679     if (%{$self->{MAN3PODS}}) {
 680         push @m, qq[
 681 config :: \$(INST_MAN3DIR)\\.exists
 682         $self->{NOECHO}\$(NOOP)
 683
 684 ];
 685         push @m, $self->dir_target(qw[$(INST_MAN3DIR)]);
 686     }
 687
 688     push @m, '
 689 $(O_FILES): $(H_FILES)
 690 ' if @{$self->{O_FILES} || []} && @{$self->{H} || []};
 691
 692     push @m, q{
 693 help:
 694         perldoc ExtUtils::MakeMaker
 695 };
 696
 697     join('',@m);
 698 }
 699
 700 =item manifypods (o)
 701
 702 We don't want manpage process.
 703
 704 =cut
 705
 706 sub manifypods {
 707     my($self) = shift;
 708     return "\nmanifypods :\n\t$self->{NOECHO}\$(NOOP)\n";
 709 }
 710
 711 =item dist_ci (o)
 712
 713 Same as MM_Unix version (changes command-line quoting).
 714
 715 =cut
 716
 717 sub dist_ci {
 718     my($self) = shift;
 719     my @m;
 720     push @m, q{
 721 ci :
 722         $(PERLRUN) -MExtUtils::Manifest=maniread \\
 723                 -e "@all = keys %{ maniread() };" \\
 724                 -e "print(\"Executing $(CI) @all\n\"); system(\"$(CI) @all\");" \\
 725                 -e "print(\"Executing $(RCS_LABEL) ...\n\"); system(\"$(RCS_LABEL) @all\");"
 726 };
 727     join "", @m;
 728 }
 729
 730 =item dist_core (o)
 731
 732 Same as MM_Unix version (changes command-line quoting).
 733
 734 =cut
 735
 736 sub dist_core {
 737     my($self) = shift;
 738     my @m;
 739     push @m, q{
 740 dist : $(DIST_DEFAULT)
 741         }.$self->{NOECHO}.q{$(PERL) -le "print \"Warning: Makefile possibly out of date with $$vf\" if " \
 742             -e "-e ($$vf=\"$(VERSION_FROM)\") and -M $$vf < -M \"}.$self->{MAKEFILE}.q{\";"
 743
 744 tardist : $(DISTVNAME).tar$(SUFFIX)
 745
 746 zipdist : $(DISTVNAME).zip
 747
 748 $(DISTVNAME).tar$(SUFFIX) : distdir
 749         $(PREOP)
 750         $(TO_UNIX)
 751         $(TAR) $(TARFLAGS) $(DISTVNAME).tar $(DISTVNAME)
 752         $(RM_RF) $(DISTVNAME)
 753         $(COMPRESS) $(DISTVNAME).tar
 754         $(POSTOP)
 755
 756 $(DISTVNAME).zip : distdir
 757         $(PREOP)
 758         $(ZIP) $(ZIPFLAGS) $(DISTVNAME).zip $(DISTVNAME)
 759         $(RM_RF) $(DISTVNAME)
 760         $(POSTOP)
 761
 762 uutardist : $(DISTVNAME).tar$(SUFFIX)
 763         uuencode $(DISTVNAME).tar$(SUFFIX) \\
 764                 $(DISTVNAME).tar$(SUFFIX) > \\
 765                 $(DISTVNAME).tar$(SUFFIX)_uu
 766
 767 shdist : distdir
 768         $(PREOP)
 769         $(SHAR) $(DISTVNAME) > $(DISTVNAME).shar
 770         $(RM_RF) $(DISTVNAME)
 771         $(POSTOP)
 772 };
 773     join "", @m;
 774 }
 775
 776 =item pasthru (o)
 777
 778 Defines the string that is passed to recursive make calls in
 779 subdirectories.
 780
 781 =cut
 782
 783 sub pasthru {
 784     my($self) = shift;
 785     return "PASTHRU = " . ($NMAKE ? "-nologo" : "");
 786 }
 787
 788
 789
 790 1;
 791 __END__
 792
 793 =back
 794
 795 =cut
 796
 797