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