lib/ExtUtils/MM_Win32.pm

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