This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
[inseparable changes from match from perl-5.003_93 to perl-5.003_94]
[perl5.git] / lib / ExtUtils / MM_Win32.pm
CommitLineData
68dc0745
PP
1package ExtUtils::MM_Win32;
2
3=head1 NAME
4
5ExtUtils::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
13See ExtUtils::MM_Unix for a documentation of the methods provided
14there. This package overrides the implementation of these methods, not
15the semantics.
16
17=over
18
19=cut
20
21#use Config;
22#use Cwd;
23use File::Basename;
24require Exporter;
25
26Exporter::import('ExtUtils::MakeMaker',
27 qw( $Verbose &neatvalue));
28
29$ENV{EMXSHELL} = 'sh'; # to run `commands`
30unshift @MM::ISA, 'ExtUtils::MM_Win32';
31
32sub dlsyms {
33 my($self,%attribs) = @_;
34
35 my($funcs) = $attribs{DL_FUNCS} || $self->{DL_FUNCS} || {};
36 my($vars) = $attribs{DL_VARS} || $self->{DL_VARS} || [];
37 my($imports) = $attribs{IMPORTS} || $self->{IMPORTS} || {};
38 my(@m);
39 (my $boot = $self->{NAME}) =~ s/:/_/g;
40
41 if (not $self->{SKIPHASH}{'dynamic'}) {
42 push(@m,"
43$self->{BASEEXT}.def: Makefile.PL
44",
45 q! $(PERL) "-I$(PERL_ARCHLIB)" "-I$(PERL_LIB)" -MExtUtils::Mksymlists \\
46 -e "Mksymlists('NAME' => '!, $self->{NAME},
47 q!', 'DLBASE' => '!,$self->{DLBASE},
48 q!', 'DL_FUNCS' => !,neatvalue($funcs),
49 q!, 'IMPORTS' => !,neatvalue($imports),
50 q!, 'DL_VARS' => !, neatvalue($vars), q!);"
51!);
52 }
53 join('',@m);
54}
55
56sub replace_manpage_separator {
57 my($self,$man) = @_;
58 $man =~ s,/+,.,g;
59 $man;
60}
61
62sub maybe_command {
63 my($self,$file) = @_;
64 return "$file.exe" if -e "$file.exe";
65 return;
66}
67
68sub file_name_is_absolute {
69 my($self,$file) = @_;
70 $file =~ m{^([a-z]:)?[\\/]}i ;
71}
72
73sub find_perl {
74 my($self, $ver, $names, $dirs, $trace) = @_;
75 my($name, $dir);
76 if ($trace >= 2){
77 print "Looking for perl $ver by these names:
78@$names
79in these dirs:
80@$dirs
81";
82 }
83 foreach $dir (@$dirs){
84 next unless defined $dir; # $self->{PERL_SRC} may be undefined
85 foreach $name (@$names){
86 my ($abs, $val);
87 if ($self->file_name_is_absolute($name)) { # /foo/bar
88 $abs = $name;
89 } elsif ($self->canonpath($name) eq $self->canonpath(basename($name))) { # foo
90 $abs = $self->catfile($dir, $name);
91 } else { # foo/bar
92 $abs = $self->canonpath($self->catfile($self->curdir, $name));
93 }
94 print "Checking $abs\n" if ($trace >= 2);
95 next unless $self->maybe_command($abs);
96 print "Executing $abs\n" if ($trace >= 2);
97 $val = `$abs -e "require $ver;" 2>&1`;
98 if ($? == 0) {
99 print "Using PERL=$abs\n" if $trace;
100 return $abs;
101 } elsif ($trace >= 2) {
102 print "Result: `$val'\n";
103 }
104 }
105 }
106 print STDOUT "Unable to find a perl $ver (by these names: @$names, in these dirs: @$dirs)\n";
107 0; # false and not empty
108}
109
110sub catdir {
111 my $self = shift;
112 my @args = @_;
113 for (@args) {
114 # append a slash to each argument unless it has one there
115 $_ .= "\\" if $_ eq '' or substr($_,-1) ne "\\";
116 }
117 my $result = $self->canonpath(join('', @args));
118 $result;
119}
120
121=item catfile
122
123Concatenate one or more directory names and a filename to form a
124complete path ending with a filename
125
126=cut
127
128sub catfile {
129 my $self = shift @_;
130 my $file = pop @_;
131 return $file unless @_;
132 my $dir = $self->catdir(@_);
133 for ($dir) {
134 $_ .= "\\" unless substr($_,length($_)-1,1) eq "\\";
135 }
136 return $dir.$file;
137}
138
139sub init_others
140{
141 my ($self) = @_;
142 &ExtUtils::MM_Unix::init_others;
143 $self->{'TOUCH'} = '$(PERL) -I$(PERL_ARCHLIB) -I$(PERL_LIB) -MExtUtils::Command -e touch';
144 $self->{'CHMOD'} = '$(PERL) -I$(PERL_ARCHLIB) -I$(PERL_LIB) -MExtUtils::Command -e chmod';
145 $self->{'CP'} = '$(PERL) -I$(PERL_ARCHLIB) -I$(PERL_LIB) -MExtUtils::Command -e cp';
146 $self->{'RM_F'} = '$(PERL) -I$(PERL_ARCHLIB) -I$(PERL_LIB) -MExtUtils::Command -e rm_f';
147 $self->{'RM_RF'} = '$(PERL) -I$(PERL_ARCHLIB) -I$(PERL_LIB) -MExtUtils::Command -e rm_rf';
148 $self->{'MV'} = '$(PERL) -I$(PERL_ARCHLIB) -I$(PERL_LIB) -MExtUtils::Command -e mv';
149 $self->{'NOOP'} = 'rem';
150 $self->{'TEST_F'} = '$(PERL) -I$(PERL_ARCHLIB) -I$(PERL_LIB) -MExtUtils::Command -e test_f';
151 $self->{'LD'} = 'link';
152 $self->{'DEV_NULL'} = '> NUL';
153 # $self->{'NOECHO'} = ''; # till we have it working
154}
155
156sub path {
157 local $^W = 1;
158 my($self) = @_;
159 my $path = $ENV{'PATH'} || $ENV{'Path'} || $ENV{'path'};
160 my @path = split(';',$path);
161 foreach(@path) { $_ = '.' if $_ eq '' }
162 @path;
163}
164
165=item static_lib (o)
166
167Defines how to produce the *.a (or equivalent) files.
168
169=cut
170
171sub static_lib {
172 my($self) = @_;
173# Come to think of it, if there are subdirs with linkcode, we still have no INST_STATIC
174# return '' unless $self->needs_linking(); #might be because of a subdir
175
176 return '' unless $self->has_link_code;
177
178 my(@m);
179 push(@m, <<'END');
180$(INST_STATIC): $(OBJECT) $(MYEXTLIB) $(INST_ARCHAUTODIR)/.exists
181 $(RM_RF) $@
182END
183 # If this extension has it's own library (eg SDBM_File)
184 # then copy that to $(INST_STATIC) and add $(OBJECT) into it.
185 push(@m, "\t$self->{CP} \$(MYEXTLIB) \$\@\n") if $self->{MYEXTLIB};
186
187 push @m,
188q{ lib -nologo -out:$@ $(OBJECT)
189 }.$self->{NOECHO}.q{echo "$(EXTRALIBS)" > $(INST_ARCHAUTODIR)/extralibs.ld
190 $(CHMOD) 755 $@
191};
192
193# Old mechanism - still available:
194
195 push @m, "\t$self->{NOECHO}".q{echo "$(EXTRALIBS)" >> $(PERL_SRC)/ext.libs}."\n\n"
196 if $self->{PERL_SRC};
197
198 push @m, $self->dir_target('$(INST_ARCHAUTODIR)');
199 join('', "\n",@m);
200}
201
202
203
204=item dynamic_lib (o)
205
206Defines how to produce the *.so (or equivalent) files.
207
208=cut
209
210sub dynamic_lib {
211 my($self, %attribs) = @_;
212 return '' unless $self->needs_linking(); #might be because of a subdir
213
214 return '' unless $self->has_link_code;
215
216 my($otherldflags) = $attribs{OTHERLDFLAGS} || "";
217 my($inst_dynamic_dep) = $attribs{INST_DYNAMIC_DEP} || "";
218 my($ldfrom) = '$(LDFROM)';
219 my(@m);
220 push(@m,'
221# This section creates the dynamically loadable $(INST_DYNAMIC)
222# from $(OBJECT) and possibly $(MYEXTLIB).
223OTHERLDFLAGS = '.$otherldflags.'
224INST_DYNAMIC_DEP = '.$inst_dynamic_dep.'
225
226$(INST_DYNAMIC): $(OBJECT) $(MYEXTLIB) $(BOOTSTRAP) $(INST_ARCHAUTODIR)/.exists $(EXPORT_LIST) $(PERL_ARCHIVE) $(INST_DYNAMIC_DEP)
227');
228
229 push(@m,' $(LD) -out:$@ $(LDDLFLAGS) '.$ldfrom.
230 ' $(OTHERLDFLAGS) $(MYEXTLIB) $(PERL_ARCHIVE) $(LDLOADLIBS) -def:$(EXPORT_LIST)');
231 push @m, '
232 $(CHMOD) 755 $@
233';
234
235 push @m, $self->dir_target('$(INST_ARCHAUTODIR)');
236 join('',@m);
237}
238
239sub perl_archive
240{
241 return '$(PERL_INC)\perl$(LIB_EXT)';
242}
243
244sub export_list
245{
246 my ($self) = @_;
247 return "$self->{BASEEXT}.def";
248}
249
250=item canonpath
251
252No physical check on the filesystem, but a logical cleanup of a
253path. On UNIX eliminated successive slashes and successive "/.".
254
255=cut
256
257sub canonpath {
258 my($self,$path) = @_;
259 $path =~ s|/|\\|g;
260 $path =~ s|\\+|\\|g ; # xx////xx -> xx/xx
261 $path =~ s|(\\\.)+\\|\\|g ; # xx/././xx -> xx/xx
262 $path =~ s|^(\.\\)+|| unless $path eq ".\\"; # ./xx -> xx
263 $path =~ s|\\$||
264 unless $path =~ m#^([a-z]:)?\\#; # xx/ -> xx
265 $path .= '.' if $path =~ m#\\$#;
266 $path;
267}
268
269=item perl_script
270
271Takes one argument, a file name, and returns the file name, if the
272argument is likely to be a perl script. On MM_Unix this is true for
273any ordinary, readable file.
274
275=cut
276
277sub perl_script {
278 my($self,$file) = @_;
279 return "$file.pl" if -r "$file.pl" && -f _;
280 return;
281}
282
283=item pm_to_blib
284
285Defines target that copies all files in the hash PM to their
286destination and autosplits them. See L<ExtUtils::Install/DESCRIPTION>
287
288=cut
289
290sub pm_to_blib {
291 my $self = shift;
292 my($autodir) = $self->catdir('$(INST_LIB)','auto');
293 return q{
294pm_to_blib: $(TO_INST_PM)
295 }.$self->{NOECHO}.q{$(PERL) "-I$(INST_ARCHLIB)" "-I$(INST_LIB)" \
296 "-I$(PERL_ARCHLIB)" "-I$(PERL_LIB)" -MExtUtils::Install \
297 -e "pm_to_blib(qw{ <<pmfiles.dat },'}.$autodir.q{')"
298 }.q{
299$(PM_TO_BLIB)
300<<
301 }.$self->{NOECHO}.q{$(TOUCH) $@
302};
303}
304
305=item test_via_harness (o)
306
307Helper method to write the test targets
308
309=cut
310
311sub test_via_harness {
312 my($self, $perl, $tests) = @_;
313 "\t$perl".q! -Mblib -I$(PERL_ARCHLIB) -I$(PERL_LIB) -e "use Test::Harness qw(&runtests $$verbose); $$verbose=$(TEST_VERBOSE); runtests @ARGV;" !."$tests\n";
314}
315
316=item tool_autosplit (override)
317
318Use Win32 quoting on command line.
319
320=cut
321
322sub tool_autosplit{
323 my($self, %attribs) = @_;
324 my($asl) = "";
325 $asl = "\$AutoSplit::Maxlen=$attribs{MAXLEN};" if $attribs{MAXLEN};
326 q{
327# Usage: $(AUTOSPLITFILE) FileToSplit AutoDirToSplitInto
328AUTOSPLITFILE = $(PERL) "-I$(PERL_ARCHLIB)" "-I$(PERL_LIB)" -MAutoSplit }.$asl.q{ -e "autosplit($$ARGV[0], $$ARGV[1], 0, 1, 1);"
329};
330}
331
332=item tools_other (o)
333
334Win32 overrides.
335
336Defines SHELL, LD, TOUCH, CP, MV, RM_F, RM_RF, CHMOD, UMASK_NULL in
337the Makefile. Also defines the perl programs MKPATH,
338WARN_IF_OLD_PACKLIST, MOD_INSTALL. DOC_INSTALL, and UNINSTALL.
339
340=cut
341
342sub tools_other {
343 my($self) = shift;
344 my @m;
345 my $bin_sh = $Config{sh} || 'cmd /c';
346 push @m, qq{
347SHELL = $bin_sh
348};
349
350 for (qw/ CHMOD CP LD MV NOOP RM_F RM_RF TEST_F TOUCH UMASK_NULL DEV_NULL/ ) {
351 push @m, "$_ = $self->{$_}\n";
352 }
353
354 push @m, q{
355# The following is a portable way to say mkdir -p
356# To see which directories are created, change the if 0 to if 1
357MKPATH = $(PERL) -I$(PERL_ARCHLIB) -I$(PERL_LIB) -MExtUtils::Command -e mkpath
358
359# This helps us to minimize the effect of the .exists files A yet
360# better solution would be to have a stable file in the perl
361# distribution with a timestamp of zero. But this solution doesn't
362# need any changes to the core distribution and works with older perls
363EQUALIZE_TIMESTAMP = $(PERL) -I$(PERL_ARCHLIB) -I$(PERL_LIB) -MExtUtils::Command -e eqtime
364};
365
366
367 return join "", @m if $self->{PARENT};
368
369 push @m, q{
370# Here we warn users that an old packlist file was found somewhere,
371# and that they should call some uninstall routine
372WARN_IF_OLD_PACKLIST = $(PERL) -lwe "exit unless -f $$ARGV[0];" \\
373-e "print 'WARNING: I have found an old package in';" \\
374-e "print ' ', $$ARGV[0], '.';" \\
375-e "print 'Please make sure the two installations are not conflicting';"
376
377UNINST=0
378VERBINST=1
379
380MOD_INSTALL = $(PERL) -I$(INST_LIB) -I$(PERL_LIB) -MExtUtils::Install \
381-e "install({@ARGV},'$(VERBINST)',0,'$(UNINST)');"
382
383DOC_INSTALL = $(PERL) -e "$$\=\"\n\n\";" \
384-e "print '=head2 ', scalar(localtime), ': C<', shift, '>', ' L<', shift, '>';" \
385-e "print '=over 4';" \
386-e "while (defined($$key = shift) and defined($$val = shift)){print '=item *';print 'C<', \"$$key: $$val\", '>';}" \
387-e "print '=back';"
388
389UNINSTALL = $(PERL) -MExtUtils::Install \
390-e "uninstall($$ARGV[0],1,1); print \"\nUninstall is deprecated. Please check the";" \
391-e "print \" packlist above carefully.\n There may be errors. Remove the\";" \
392-e "print \" appropriate files manually.\n Sorry for the inconveniences.\n\""
393};
394
395 return join "", @m;
396}
397
398=item manifypods (o)
399
400We don't want manpage process. XXX add pod2html support later.
401
402=cut
403
404sub manifypods {
405 return "\nmanifypods :\n\t$self->{NOECHO}\$(NOOP)\n";
406}
407
408=item dist_ci (o)
409
410Same as MM_Unix version (changes command-line quoting).
411
412=cut
413
414sub dist_ci {
415 my($self) = shift;
416 my @m;
417 push @m, q{
418ci :
419 $(PERL) -I$(PERL_ARCHLIB) -I$(PERL_LIB) -MExtUtils::Manifest=maniread \\
420 -e "@all = keys %{ maniread() };" \\
421 -e "print(\"Executing $(CI) @all\n\"); system(\"$(CI) @all\");" \\
422 -e "print(\"Executing $(RCS_LABEL) ...\n\"); system(\"$(RCS_LABEL) @all\");"
423};
424 join "", @m;
425}
426
427=item dist_core (o)
428
429Same as MM_Unix version (changes command-line quoting).
430
431=cut
432
433sub dist_core {
434 my($self) = shift;
435 my @m;
436 push @m, q{
437dist : $(DIST_DEFAULT)
438 }.$self->{NOECHO}.q{$(PERL) -le "print \"Warning: Makefile possibly out of date with $$vf\" if " \
439 -e "-e ($$vf=\"$(VERSION_FROM)\") and -M $$vf < -M \"}.$self->{MAKEFILE}.q{\";"
440
441tardist : $(DISTVNAME).tar$(SUFFIX)
442
443zipdist : $(DISTVNAME).zip
444
445$(DISTVNAME).tar$(SUFFIX) : distdir
446 $(PREOP)
447 $(TO_UNIX)
448 $(TAR) $(TARFLAGS) $(DISTVNAME).tar $(DISTVNAME)
449 $(RM_RF) $(DISTVNAME)
450 $(COMPRESS) $(DISTVNAME).tar
451 $(POSTOP)
452
453$(DISTVNAME).zip : distdir
454 $(PREOP)
455 $(ZIP) $(ZIPFLAGS) $(DISTVNAME).zip $(DISTVNAME)
456 $(RM_RF) $(DISTVNAME)
457 $(POSTOP)
458
459uutardist : $(DISTVNAME).tar$(SUFFIX)
460 uuencode $(DISTVNAME).tar$(SUFFIX) \\
461 $(DISTVNAME).tar$(SUFFIX) > \\
462 $(DISTVNAME).tar$(SUFFIX)_uu
463
464shdist : distdir
465 $(PREOP)
466 $(SHAR) $(DISTVNAME) > $(DISTVNAME).shar
467 $(RM_RF) $(DISTVNAME)
468 $(POSTOP)
469};
470 join "", @m;
471}
472
473=item pasthru (o)
474
475Defines the string that is passed to recursive make calls in
476subdirectories.
477
478=cut
479
480sub pasthru {
481 my($self) = shift;
482 return "PASTHRU = /nologo"
483}
484
485
486
4871;
488__END__
489
490=back
491
492=cut
493