additions to Thread.pm docs from Tuomas J. Lukka
[p5sagit/p5-mst-13.2.git] / Makefile.SH
1 #! /bin/sh
2 case $CONFIGDOTSH in
3 '')
4         if test -f config.sh; then TOP=.;
5         elif test -f ../config.sh; then TOP=..;
6         elif test -f ../../config.sh; then TOP=../..;
7         elif test -f ../../../config.sh; then TOP=../../..;
8         elif test -f ../../../../config.sh; then TOP=../../../..;
9         else
10                 echo "Can't find config.sh."; exit 1
11         fi
12         . $TOP/config.sh
13         ;;
14 esac
15 : This forces SH files to create target in same directory as SH file.
16 : This is so that make depend always knows where to find SH derivatives.
17 case "$0" in
18 */*) cd `expr X$0 : 'X\(.*\)/'` ;;
19 esac
20
21 case "$d_dosuid" in
22 *define*) suidperl='suidperl' ;;
23 *) suidperl='';;
24 esac
25
26 linklibperl='$(LIBPERL)'
27 shrpldflags='$(LDDLFLAGS)'
28 ldlibpth=''
29 case "$useshrplib" in
30 true)
31         # Prefix all runs of 'miniperl' and 'perl' with 
32         # $ldlibpth so that ./perl finds *this* libperl.so.
33         ldlibpth="LD_LIBRARY_PATH=`pwd`:$LD_LIBRARY_PATH"
34
35         pldlflags="$cccdlflags"
36         # NeXT-4 specific stuff.  Can't we do this in the hint file?
37         case "${osname}${osvers}" in
38         next4*)
39                 ld=libtool
40                 lddlflags="-dynamic -undefined warning -framework System \
41                 -compatibility_version 1 -current_version $patchlevel \
42                 -prebind -seg1addr 0x27000000 -install_name \$(shrpdir)/\$@"
43                 # NeXT uses a different name.
44                 ldlibpth="DYLD_LIBRARY_PATH=`pwd`:$DYLD_LIBRARY_PATH"
45                 ;;
46         rhapsody*)
47                 ldlibpth="DYLD_LIBRARY_PATH=`pwd`/Perl:$DYLD_LIBRARY_PATH"
48                 ;;
49         os2*)   # OS/2 doesn't need anything special for LD_LIBRARY_PATH.
50                 ldlibpth=''
51                 ;;
52         sunos*)
53                 linklibperl="-lperl"
54                 ;;
55         netbsd*|freebsd[234]*)
56                 linklibperl="-L. -lperl"
57                 ;;
58         aix*)
59                 shrpldflags="-H512 -T512 -bhalt:4 -bM:SRE -bE:perl.exp"
60                 case "$osvers" in
61                 3*)
62                         shrpldflags="$shrpldflags -e _nostart $ldflags $libs $cryptlib"
63                         ;;
64                 *)
65                         shrpldflags="$shrpldflags -b noentry $ldflags $libs $cryptlib"
66                         ;;
67                 esac
68                 aixinstdir=`pwd | sed 's/\/UU$//'`
69                 linklibperl="-L $archlibexp/CORE -L $aixinstdir -lperl"
70                 ;;
71         hpux*)
72                 linklibperl="-L `pwd | sed 's/\/UU$//'` -Wl,+s -Wl,+b$archlibexp/CORE -lperl"
73                 ldlibpth="SHLIB_PATH=`pwd`:${SHLIB_PATH}"
74                 ;;
75         beos*)  ldlibpth="LIBRARY_PATH=`pwd`:$LIBRARY_PATH"
76                 ;;
77         esac
78         ;;
79 *)      pldlflags=''
80         ;;
81 esac
82
83 : Prepare dependency lists for Makefile.
84 dynamic_list=' '
85 for f in $dynamic_ext; do
86     : the dependency named here will never exist
87       base=`echo "$f" | sed 's/.*\///'`
88     dynamic_list="$dynamic_list lib/auto/$f/$base.$dlext"
89 done
90
91 static_list=' '
92 for f in $static_ext; do
93         base=`echo "$f" | sed 's/.*\///'`
94         static_list="$static_list lib/auto/$f/$base\$(LIB_EXT)"
95 done
96
97 nonxs_list=' '
98 for f in $nonxs_ext; do
99     base=`echo "$f" | sed 's/.*\///'`
100     nonxs_list="$nonxs_list ext/$f/pm_to_blib"
101 done
102
103 echo "Extracting Makefile (with variable substitutions)"
104 $spitshell >Makefile <<!GROK!THIS!
105 # Makefile.SH
106 # This file is derived from Makefile.SH.  Any changes made here will
107 # be lost the next time you run Configure.
108 #  Makefile is used to generate $firstmakefile.  The only difference
109 #  is that $firstmakefile has the dependencies filled in at the end.
110 #
111 #
112 # I now supply perly.c with the kits, so don't remake perly.c without byacc
113 BYACC = $byacc
114 CC = $cc
115 LD = $ld
116
117 LDFLAGS = $ldflags
118 CLDFLAGS = $ldflags
119
120 SMALL = $small
121 LARGE = $large $split
122 mallocsrc = $mallocsrc
123 mallocobj = $mallocobj
124 LNS = $lns
125 RMS = rm -f
126 ranlib = $ranlib
127
128 # The following are mentioned only to make metaconfig include the
129 # appropriate questions in Configure.  If you want to change these,
130 # edit config.sh instead, or specify --man1dir=/wherever on
131 # installman commandline.
132 bin = $installbin
133 scriptdir = $scriptdir
134 shrpdir = $archlibexp/CORE
135 privlib = $installprivlib
136 man1dir = $man1dir
137 man1ext = $man1ext
138 man3dir = $man3dir
139 man3ext = $man3ext
140
141 # The following are used to build and install shared libraries for
142 # dynamic loading.
143 LDDLFLAGS = $lddlflags
144 SHRPLDFLAGS = $shrpldflags
145 CCDLFLAGS = $ccdlflags
146 DLSUFFIX = .$dlext
147 PLDLFLAGS = $pldlflags
148 LIBPERL = $libperl
149 LLIBPERL= $linklibperl
150 SHRPENV = $shrpenv
151
152 # The following is used to include the current directory in
153 # LD_LIBRARY_PATH if you are building a shared libperl.so.
154 LDLIBPTH = $ldlibpth
155
156 dynamic_ext = $dynamic_list
157 static_ext = $static_list
158 nonxs_ext = $nonxs_list
159 ext = \$(dynamic_ext) \$(static_ext) \$(nonxs_ext)
160 DYNALOADER = lib/auto/DynaLoader/DynaLoader\$(LIB_EXT)
161
162 libs = $libs $cryptlib
163
164 public = perl $suidperl utilities translators
165
166 shellflags = $shellflags
167
168 # This is set to  MAKE=$make if your $make command doesn't
169 # do it for you.
170 $make_set_make
171
172 # These variables may need to be manually set for non-Unix systems.
173 AR = $full_ar
174 EXE_EXT = $_exe
175 LIB_EXT = $_a
176 OBJ_EXT = $_o
177 PATH_SEP = $p_
178
179 FIRSTMAKEFILE = $firstmakefile
180
181 # Any special object files needed by this architecture, e.g. os2/os2.obj
182 ARCHOBJS = $archobjs
183
184 .SUFFIXES: .c \$(OBJ_EXT)
185
186 # grrr
187 SHELL = $sh
188
189 # how to tr(anslate) newlines
190 TRNL = '$trnl'
191
192 !GROK!THIS!
193
194 ## In the following dollars and backticks do not need the extra backslash.
195 $spitshell >>Makefile <<'!NO!SUBS!'
196
197 CCCMD = `sh $(shellflags) cflags $(LIBPERL) $@`
198
199 private = preplibrary lib/ExtUtils/Miniperl.pm lib/Config.pm
200
201 # Files to be built with variable substitution before miniperl
202 # is available.
203 sh = Makefile.SH cflags.SH config_h.SH makeaperl.SH makedepend.SH \
204         makedir.SH perl_exp.SH writemain.SH
205
206 shextract = Makefile cflags config.h makeaperl makedepend \
207         makedir perl.exp writemain
208
209 # Files to be built with variable substitution after miniperl is
210 # available.  Dependencies handled manually below (for now).
211
212 pl = pod/pod2html.PL pod/pod2latex.PL pod/pod2man.PL pod/pod2text.PL \
213         pod/pod2usage.PL pod/podchecker.PL pod/podselect.PL
214
215 plextract = pod/pod2html pod/pod2latex pod/pod2man pod/pod2text \
216         pod/pod2usage pod/podchecker pod/podselect
217
218 addedbyconf = UU $(shextract) $(plextract) pstruct
219
220 h1 = EXTERN.h INTERN.h XSUB.h av.h config.h cop.h cv.h dosish.h
221 h2 = embed.h form.h gv.h handy.h hv.h keywords.h mg.h op.h
222 h3 = opcode.h patchlevel.h perl.h perly.h pp.h proto.h regcomp.h
223 h4 = regexp.h scope.h sv.h unixish.h util.h iperlsys.h thread.h
224 h5 = bytecode.h byterun.h utf8.h warning.h
225 h = $(h1) $(h2) $(h3) $(h4) $(h5)
226
227 c1 = $(mallocsrc) av.c scope.c op.c doop.c doio.c dump.c hv.c mg.c byterun.c
228 c2 = perl.c perly.c pp.c pp_hot.c pp_ctl.c pp_sys.c regcomp.c regexec.c utf8.c
229 c3 = gv.c sv.c taint.c toke.c util.c deb.c run.c universal.c globals.c perlio.c
230
231 c = $(c1) $(c2) $(c3) miniperlmain.c perlmain.c
232
233 obj1 = $(mallocobj) gv$(OBJ_EXT) toke$(OBJ_EXT) perly$(OBJ_EXT) op$(OBJ_EXT) regcomp$(OBJ_EXT) dump$(OBJ_EXT) util$(OBJ_EXT) mg$(OBJ_EXT) byterun$(OBJ_EXT)
234 obj2 = hv$(OBJ_EXT) av$(OBJ_EXT) run$(OBJ_EXT) pp_hot$(OBJ_EXT) sv$(OBJ_EXT) pp$(OBJ_EXT) scope$(OBJ_EXT) pp_ctl$(OBJ_EXT) pp_sys$(OBJ_EXT)
235 obj3 = doop$(OBJ_EXT) doio$(OBJ_EXT) regexec$(OBJ_EXT) utf8$(OBJ_EXT) taint$(OBJ_EXT) deb$(OBJ_EXT) universal$(OBJ_EXT) globals$(OBJ_EXT) perlio$(OBJ_EXT)
236
237 obj = $(obj1) $(obj2) $(obj3) $(ARCHOBJS)
238
239 # Once perl has been Configure'd and built ok you build different
240 # perl variants (Debugging, Embedded, Multiplicity etc) by saying:
241 #       make clean; make LIBPERL=libperl<type>.a
242 # where <type> is some combination of 'd' and(or) 'e' or 'm'.
243 # See cflags to understand how this works.
244 #
245 # This mechanism is getting clunky and might not even work any more.
246 # EMBEDDING is on by default, and MULTIPLICITY doesn't work.
247 #
248
249 lintflags = -hbvxac
250
251 .c$(OBJ_EXT):
252         $(CCCMD) $(PLDLFLAGS) $*.c
253
254 all: $(FIRSTMAKEFILE) miniperl $(private) $(plextract) $(public) $(dynamic_ext) $(nonxs_ext)
255         @echo " ";
256         @echo " Everything is up to date. 'make test' to run test suite."
257
258 compile: all
259         echo "testing compilation" > testcompile;
260         cd utils;  $(MAKE) compile;
261         cd x2p; $(MAKE) compile; 
262         cd pod; $(MAKE) compile;
263
264 translators:    miniperl lib/Config.pm FORCE
265         @echo " "; echo "       Making x2p stuff"; cd x2p; $(LDLIBPTH) $(MAKE) all
266
267 utilities:      miniperl lib/Config.pm FORCE
268         @echo " "; echo "       Making utilities"; cd utils; $(LDLIBPTH) $(MAKE) all
269
270
271 # This is now done by installman only if you actually want the man pages.
272 #       @echo " "; echo "       Making docs"; cd pod; $(MAKE) all;
273
274 # Phony target to force checking subdirectories.
275 # Apparently some makes require an action for the FORCE target.
276 FORCE:
277         @sh -c true
278
279 miniperlmain$(OBJ_EXT): miniperlmain.c
280         $(CCCMD) $(PLDLFLAGS) $*.c
281
282 perlmain.c: miniperlmain.c config.sh $(FIRSTMAKEFILE)
283         sh writemain $(DYNALOADER) $(static_ext) > writemain.tmp
284         sh mv-if-diff writemain.tmp perlmain.c
285
286 perlmain$(OBJ_EXT): perlmain.c
287         $(CCCMD) $(PLDLFLAGS) $*.c
288
289 # The file ext.libs is a list of libraries that must be linked in
290 # for static extensions, e.g. -lm -lgdbm, etc.  The individual
291 # static extension Makefile's add to it.
292 ext.libs: $(static_ext)
293         -@test -f ext.libs || touch ext.libs
294
295 !NO!SUBS!
296
297 # How to build libperl.  This is still rather convoluted.
298 # Load up custom Makefile.SH fragment for shared loading and executables:
299 if test -r $osname/Makefile.SHs ; then
300         . $osname/Makefile.SHs
301         $spitshell >>Makefile <<!GROK!THIS!
302
303 Makefile: $osname/Makefile.SHs
304 !GROK!THIS!
305 else
306         $spitshell >>Makefile <<'!NO!SUBS!'
307 $(LIBPERL): $& perl$(OBJ_EXT) $(obj)
308 !NO!SUBS!
309         case "$useshrplib" in
310         true)
311                 $spitshell >>Makefile <<'!NO!SUBS!'
312         $(LD) $(SHRPLDFLAGS) -o $@ perl$(OBJ_EXT) $(obj)
313 !NO!SUBS!
314                 case "$osname" in
315                 aix)
316                         $spitshell >>Makefile <<'!NO!SUBS!'
317         rm -f libperl$(OBJ_EXT)
318         mv $@ libperl$(OBJ_EXT)
319         $(AR) qv $(LIBPERL) libperl$(OBJ_EXT)
320 !NO!SUBS!
321                         ;;
322                 esac
323                 ;;
324         *)
325                 $spitshell >>Makefile <<'!NO!SUBS!'
326         rm -f $(LIBPERL)
327         $(AR) rcu $(LIBPERL) perl$(OBJ_EXT) $(obj)
328         @$(ranlib) $(LIBPERL)
329 !NO!SUBS!
330                 ;;
331         esac
332         $spitshell >>Makefile <<'!NO!SUBS!'
333
334 # How to build executables.
335
336 # The $& notation tells Sequent machines that it can do a parallel make,
337 # and is harmless otherwise.
338 # The miniperl -w -MExporter line is a basic cheap test to catch errors
339 # before make goes on to run preplibrary and then MakeMaker on extensions.
340 # This is very handy because later errors are often caused by miniperl
341 # build problems but that's not obvious to the novice.
342 # The Module used here must not depend on Config or any extensions.
343
344 miniperl: $& miniperlmain$(OBJ_EXT) $(LIBPERL)
345         $(LDLIBPTH) $(CC) $(LARGE) $(CLDFLAGS) -o miniperl miniperlmain$(OBJ_EXT) $(LLIBPERL) $(libs)
346         $(LDLIBPTH) ./miniperl -w -Ilib -MExporter -e 0 || $(MAKE) minitest
347
348 perl: $& perlmain$(OBJ_EXT) $(LIBPERL) $(DYNALOADER) $(static_ext) ext.libs
349         $(SHRPENV) $(LDLIBPTH) $(CC) $(LARGE) $(CLDFLAGS) $(CCDLFLAGS) -o perl perlmain$(OBJ_EXT) $(DYNALOADER) $(static_ext) $(LLIBPERL) `cat ext.libs` $(libs)
350
351 pureperl: $& perlmain$(OBJ_EXT) $(LIBPERL) $(DYNALOADER) $(static_ext) ext.libs
352         $(SHRPENV) $(LDLIBPTH) purify $(CC) $(LARGE) $(CLDFLAGS) $(CCDLFLAGS) -o pureperl perlmain$(OBJ_EXT) $(DYNALOADER) $(static_ext) $(LLIBPERL) `cat ext.libs` $(libs)
353
354 purecovperl: $& perlmain$(OBJ_EXT) $(LIBPERL) $(DYNALOADER) $(static_ext) ext.libs
355         $(SHRPENV) $(LDLIBPTH) purecov $(CC) $(LARGE) $(CLDFLAGS) $(CCDLFLAGS) -o purecovperl perlmain$(OBJ_EXT) $(DYNALOADER) $(static_ext) $(LLIBPERL) `cat ext.libs` $(libs)
356
357 quantperl: $& perlmain$(OBJ_EXT) $(LIBPERL) $(DYNALOADER) $(static_ext) ext.libs
358         $(SHRPENV) $(LDLIBPTH) quantify $(CC) $(LARGE) $(CLDFLAGS) $(CCDLFLAGS) -o quantperl perlmain$(OBJ_EXT) $(DYNALOADER) $(static_ext) $(LLIBPERL) `cat ext.libs` $(libs)
359
360 # This version, if specified in Configure, does ONLY those scripts which need
361 # set-id emulation.  Suidperl must be setuid root.  It contains the "taint"
362 # checks as well as the special code to validate that the script in question
363 # has been invoked correctly.
364
365 suidperl: $& sperl$(OBJ_EXT) perlmain$(OBJ_EXT) $(LIBPERL) $(DYNALOADER) $(static_ext) ext.libs
366         $(SHRPENV) $(LDLIBPTH) $(CC) $(LARGE) $(CLDFLAGS) $(CCDLFLAGS) -o suidperl perlmain$(OBJ_EXT) sperl$(OBJ_EXT) $(DYNALOADER) $(static_ext) $(LLIBPERL) `cat ext.libs` $(libs)
367
368 !NO!SUBS!
369
370 fi
371
372 $spitshell >>Makefile <<'!NO!SUBS!'
373
374 sperl$(OBJ_EXT): perl.c perly.h patchlevel.h $(h)
375         $(RMS) sperl.c
376         $(LNS) perl.c sperl.c
377         $(CCCMD) -DIAMSUID sperl.c
378         $(RMS) sperl.c
379
380 # We have to call our ./makedir because Ultrix 4.3 make can't handle the line
381 #       test -d lib/auto || mkdir lib/auto
382 #
383 preplibrary: miniperl lib/Config.pm $(plextract)
384         @sh ./makedir lib/auto
385         @echo " AutoSplitting perl library"
386         $(LDLIBPTH) ./miniperl -Ilib -e 'use AutoSplit; \
387                 autosplit_lib_modules(@ARGV)' lib/*.pm lib/*/*.pm
388
389 # Take care to avoid modifying lib/Config.pm without reason
390 # (If trying to create a new port and having problems with the configpm script, 
391 # try 'make minitest' and/or commenting out the tests at the end of configpm.)
392 lib/Config.pm: config.sh miniperl configpm
393         $(LDLIBPTH) ./miniperl configpm configpm.tmp
394         sh mv-if-diff configpm.tmp $@
395
396 lib/ExtUtils/Miniperl.pm: miniperlmain.c miniperl minimod.pl lib/Config.pm
397         $(LDLIBPTH) ./miniperl minimod.pl > minimod.tmp
398         sh mv-if-diff minimod.tmp $@
399
400 lib/re.pm: ext/re/re.pm
401         rm -f $@
402         cat ext/re/re.pm > $@
403
404 $(plextract):   miniperl lib/Config.pm lib/re.pm
405         $(LDLIBPTH) ./miniperl -Ilib $@.PL
406         
407 install: all install.perl install.man
408
409 install.perl:   all installperl
410         if [ -n "$(COMPILE)" ]; \
411         then \
412                 cd utils; $(MAKE) compile; \
413                 cd ../x2p; $(MAKE) compile; \
414                 cd ../pod; $(MAKE) compile; \
415         else :; \
416         fi
417         $(LDLIBPTH) ./perl installperl
418
419 install.man:    all installman
420         $(LDLIBPTH) ./perl installman
421
422 # XXX Experimental. Hardwired values, but useful for testing.
423 # Eventually Configure could ask for some of these values.
424 install.html: all installhtml
425         $(LDLIBPTH) ./perl installhtml                   \
426       --podroot=. --podpath=. --recurse  \
427       --htmldir=$(privlib)/html     \
428       --htmlroot=$(privlib)/html    \
429       --splithead=pod/perlipc     \
430       --splititem=pod/perlfunc    \
431       --libpods=perlfunc:perlguts:perlvar:perlrun:perlop \
432       --verbose
433
434
435 # I now supply perly.c with the kits, so the following section is
436 # used only if you force byacc to run by saying
437 #       make run_byacc
438 # Since we patch up the byacc output, the perly.fixer script needs
439 # to run with precisely the same version of byacc as I use.  You
440 # normally shouldn't remake perly.[ch].
441
442 run_byacc:      FORCE
443         @ echo 'Expect' 113 shift/reduce and 1 reduce/reduce conflict
444         $(BYACC) -d perly.y
445         chmod 664 perly.c
446         sh $(shellflags) ./perly.fixer y.tab.c perly.c
447         sed -e 's/fprintf *( *stderr *,/PerlIO_printf(Perl_debug_log,/g' \
448             -e 's/y\.tab/perly/g' perly.c >perly.tmp && mv perly.tmp perly.c
449         sed -e '/^extern YYSTYPE yy/D' y.tab.h >yh.tmp && mv yh.tmp y.tab.h
450         cmp -s y.tab.h perly.h && rm -f y.tab.h || mv y.tab.h perly.h
451         chmod 664 vms/perly_c.vms vms/perly_h.vms
452         perl vms/vms_yfix.pl perly.c perly.h vms/perly_c.vms vms/perly_h.vms
453
454 # We don't want to regenerate perly.c and perly.h, but they might
455 # appear out-of-date after a patch is applied or a new distribution is
456 # made.
457 perly.c: perly.y
458         -@sh -c true
459
460 perly.h: perly.y
461         -@sh -c true
462
463 # No compat3.sym here since and including the 5.004_50.
464 # No interp.sym since 5.005_03.
465 SYM  = global.sym globvar.sym perlio.sym pp.sym
466
467 SYMH = perlvars.h intrpvar.h thrdvar.h
468
469 # The following files are generated automatically
470 #       keywords.h:     keywords.pl
471 #       opcode.h:       opcode.pl
472 #       pp_proto.h:     opcode.pl
473 #       pp.sym:         opcode.pl
474 #       embed.h:        embed.pl  [* needs pp.sym generated by opcode.pl! *]
475 #       embedvar.h:     embed.pl  [* needs pp.sym generated by opcode.pl! *]
476 #       byterun.h:      bytecode.pl
477 #       byterun.c:      bytecode.pl
478 #       lib/B/Asmdata.pm:       bytecode.pl
479 #       regnodes.h:     regcomp.pl
480 #       warning.h lib/warning.pm:       warning.pl
481 # The correct versions should be already supplied with the perl kit,
482 # in case you don't have perl available.
483 # To force them to run, type
484 #       make regen_headers
485 regen_headers:  FORCE
486         perl keywords.pl
487         perl opcode.pl
488         perl embed.pl
489         perl bytecode.pl
490         perl regcomp.pl
491         perl warning.pl
492
493 # Extensions:
494 # Names added to $(dynamic_ext) or $(static_ext) or $(nonxs_ext) will
495 # automatically get built.  There should ordinarily be no need to change
496 # any of this part of makefile.
497 #
498 # The dummy dependency is a place holder in case $(dynamic_ext) or
499 # $(static_ext) is empty.
500 #
501 # DynaLoader may be needed for extensions that use Makefile.PL.
502
503 $(DYNALOADER):  miniperl preplibrary FORCE
504         @$(LDLIBPTH) sh ext/util/make_ext static $@ MAKE=$(MAKE) LIBPERL_A=$(LIBPERL)
505
506 d_dummy $(dynamic_ext): miniperl preplibrary $(DYNALOADER) FORCE
507         @$(LDLIBPTH) sh ext/util/make_ext dynamic $@ MAKE=$(MAKE) LIBPERL_A=$(LIBPERL)
508
509 s_dummy $(static_ext):  miniperl preplibrary $(DYNALOADER) FORCE
510         @$(LDLIBPTH) sh ext/util/make_ext static $@ MAKE=$(MAKE) LIBPERL_A=$(LIBPERL)
511
512 n_dummy $(nonxs_ext):   miniperl preplibrary $(DYNALOADER) FORCE
513         @$(LDLIBPTH) sh ext/util/make_ext nonxs $@ MAKE=$(MAKE) LIBPERL_A=$(LIBPERL)
514
515 clean:          _tidy _mopup
516
517 realclean:      _cleaner _mopup
518         @echo "Note that make realclean does not delete config.sh or Policy.sh"
519
520 clobber:        _cleaner _mopup
521         rm -f config.sh cppstdin Policy.sh
522
523 distclean:      clobber
524
525 # Do not 'make _mopup' directly.
526 _mopup:
527         rm -f *$(OBJ_EXT) *$(LIB_EXT) all perlmain.c
528         rm -f perl.exp ext.libs
529         -rm -f perl.export perl.dll perl.libexp perl.map perl.def
530         -rm -f perl.loadmap miniperl.loadmap perl.prelmap miniperl.prelmap
531         rm -f perl suidperl miniperl $(LIBPERL)
532
533 # Do not 'make _tidy' directly.
534 _tidy:
535         -cd pod; $(LDLIBPTH) $(MAKE) clean
536         -cd utils; $(LDLIBPTH) $(MAKE) clean
537         -cd x2p; $(LDLIBPTH) $(MAKE) clean
538         -@for x in $(DYNALOADER) $(dynamic_ext) $(static_ext) $(nonxs_ext) ; do \
539         $(LDLIBPTH) sh ext/util/make_ext clean $$x MAKE=$(MAKE) ; \
540         done
541         rm -f testcompile compilelog
542
543 # Do not 'make _cleaner' directly.
544 _cleaner:
545         -cd os2; rm -f Makefile
546         -cd pod; $(LDLIBPTH) $(MAKE) realclean
547         -cd utils; $(LDLIBPTH) $(MAKE) realclean
548         -cd x2p; $(LDLIBPTH) $(MAKE) realclean
549         -@for x in $(DYNALOADER) $(dynamic_ext) $(static_ext) $(nonxs_ext) ; do \
550         $(LDLIBPTH) sh ext/util/make_ext realclean $$x MAKE=$(MAKE) ; \
551         done
552         rm -f *.orig */*.orig *~ */*~ core core.perl.*.? core.miniperl.*.? perl.core miniperl.core t/core t/core.perl.*.? t/perl.core t/tmp???? t/c t/perl so_locations t/nonexistent1
553         rm -rf $(addedbyconf)
554         rm -f $(FIRSTMAKEFILE) $(FIRSTMAKEFILE).old
555         rm -f $(private)
556         rm -rf lib/auto
557         rm -f lib/.exists lib/*/.exists
558         rm -f h2ph.man pstruct
559         rm -rf .config
560         rm -f testcompile compilelog
561
562 # The following lint has practically everything turned on.  Unfortunately,
563 # you have to wade through a lot of mumbo jumbo that can't be suppressed.
564 # If the source file has a /*NOSTRICT*/ somewhere, ignore the lint message
565 # for that spot.
566
567 lint: perly.c $(c)
568         lint $(lintflags) $(defs) perly.c $(c) > perl.fuzz
569
570 # Need to unset during recursion to go out of loop.
571 # The README below ensures that the dependency list is never empty and
572 # that when MAKEDEPEND is empty $(FIRSTMAKEFILE) doesn't need rebuilding.
573
574 MAKEDEPEND = Makefile makedepend
575
576 $(FIRSTMAKEFILE):       README $(MAKEDEPEND)
577         $(MAKE) depend MAKEDEPEND=
578
579 config.h: config_h.SH config.sh
580         $(SHELL) config_h.SH
581
582 # This is an AIXism.
583 perl.exp: perl_exp.SH config.sh $(SYM) $(SYMH)
584         $(SHELL) perl_exp.SH
585
586 # When done, touch perlmain.c so that it doesn't get remade each time.
587 depend: makedepend
588         sh ./makedepend MAKE=$(MAKE)
589         - test -s perlmain.c && touch perlmain.c
590         cd x2p; $(MAKE) depend
591
592 # Cannot postpone this until $firstmakefile is ready ;-)
593 makedepend: makedepend.SH config.sh
594         sh ./makedepend.SH
595
596 test-prep: miniperl perl preplibrary utilities $(dynamic_ext) $(nonxs_ext)
597         cd t && (rm -f perl$(EXE_EXT); $(LNS) ../perl$(EXE_EXT) perl$(EXE_EXT))
598
599 # Second branch is for testing without a tty or controling terminal.
600 # See t/op/stat.t
601 test check: test-prep
602         if (true </dev/tty) >/dev/null 2>&1; then \
603           cd t && $(LDLIBPTH) ./perl TEST </dev/tty; \
604         else \
605           cd t && PERL_SKIP_TTY_TEST=1 $(LDLIBPTH) ./perl TEST; \
606         fi
607
608 utest ucheck: test-prep
609         if (true </dev/tty) >/dev/null 2>&1; then \
610           cd t && $(LDLIBPTH) ./perl UTEST </dev/tty; \
611         else \
612           cd t && PERL_SKIP_TTY_TEST=1 $(LDLIBPTH) ./perl UTEST; \
613         fi
614
615 # For testing without a tty or controling terminal. See t/op/stat.t
616 test-notty: test-prep
617         cd t && PERL_SKIP_TTY_TEST=1 $(LDLIBPTH) ./perl TEST
618
619 # Can't depend on lib/Config.pm because that might be where miniperl
620 # is crashing.
621 minitest: miniperl lib/re.pm
622         @echo "You may see some irrelevant test failures if you have been unable"
623         @echo "to build lib/Config.pm."
624         - cd t && (rm -f perl$(EXE_EXT); $(LNS) ../miniperl$(EXE_EXT) perl$(EXE_EXT)) \
625                 && $(LDLIBPTH) ./perl TEST base/*.t comp/*.t cmd/*.t io/*.t op/*.t pragma/*.t </dev/tty
626
627 # Handy way to run perlbug -ok without having to install and run the
628 # installed perlbug. We don't re-run the tests here - we trust the user.
629 # Please *don't* use this unless all tests pass.
630 # If you want to report test failures, use "make nok" instead.
631 ok:     utilities
632         $(LDLIBPTH) ./perl -Ilib utils/perlbug -ok -s '(UNINSTALLED)'
633
634 okfile: utilities
635         $(LDLIBPTH) ./perl -Ilib utils/perlbug -ok -s '(UNINSTALLED)' -F perl.ok
636
637 nok:    utilities
638         $(LDLIBPTH) ./perl -Ilib utils/perlbug -nok -s '(UNINSTALLED)'
639
640 clist:  $(c)
641         echo $(c) | tr ' ' $(TRNL) >.clist
642
643 hlist:  $(h)
644         echo $(h) | tr ' ' $(TRNL) >.hlist
645
646 shlist: $(sh)
647         echo $(sh) | tr ' ' $(TRNL) >.shlist
648
649 pllist: $(pl)
650         echo $(pl) | tr ' ' $(TRNL) >.pllist
651
652 Makefile: Makefile.SH ./config.sh
653         $(SHELL) Makefile.SH
654
655 distcheck: FORCE
656         perl '-MExtUtils::Manifest=&fullcheck' -e 'fullcheck()'
657
658 elc:    emacs/cperl-mode.elc
659
660 emacs/cperl-mode.elc: emacs/cperl-mode.el
661         -cd emacs; emacs -batch -q -no-site-file -f batch-byte-compile cperl-mode.el
662
663 etags:  emacs/cperl-mode.elc
664         sh emacs/ptags
665         perl emacs/e2ctags.pl TAGS > tags
666
667 ctags:  etags
668
669 # AUTOMATICALLY GENERATED MAKE DEPENDENCIES--PUT NOTHING BELOW THIS LINE
670 # If this runs make out of memory, delete /usr/include lines.
671 !NO!SUBS!
672
673 $eunicefix Makefile
674 case `pwd` in
675 *SH)
676     $rm -f ../Makefile
677     $ln Makefile ../Makefile
678     ;;
679 esac
680 $rm -f $firstmakefile
681
682 # Now do any special processing required before building.
683
684 case "$ebcdic" in
685 $define)
686     xxx=''
687     echo "This is an EBCDIC system, checking if any parser files need regenerating." >&4
688 case "$osname" in
689 os390|posix-bc)
690     rm -f y.tab.c y.tab.h
691     # yacc must be a reentrant ("pure") Bison in BS2000 Posix!
692     yacc -d perly.y >/dev/null 2>&1
693     if cmp -s y.tab.c perly.c; then
694         rm -f y.tab.c
695     else
696         echo "perly.y -> perly.c" >&2
697         mv -f y.tab.c perly.c
698         chmod u+w perly.c
699         sed -e '/^#include "perl\.h"/a\
700 \
701 #define yydebug    PL_yydebug\
702 #define yynerrs    PL_yynerrs\
703 #define yyerrflag  PL_yyerrflag\
704 #define yychar     PL_yychar\
705 #define yyval      PL_yyval\
706 #define yylval     PL_yylval'                           \
707             -e '/YYSTYPE *yyval;/D'                     \
708             -e '/YYSTYPE *yylval;/D'                    \
709             -e '/int  yychar,/,/yynerrs;/D'             \
710             -e 's/int yydebug = 0;/yydebug = 0;/'       \
711             -e 's/[^_]realloc(/PerlMem_realloc(/g'      \
712             -e 's/fprintf *( *stderr *,/PerlIO_printf(Perl_debug_log,/g' \
713             -e 's/y\.tab/perly/g' perly.c >perly.tmp && mv perly.tmp perly.c
714         xxx="$xxx perly.c"
715     fi
716     if cmp -s y.tab.h perly.h; then
717         rm -f y.tab.h
718     else
719         echo "perly.y -> perly.h" >&2
720         mv -f y.tab.h perly.h
721         xxx="$xxx perly.h"
722     fi
723     if cd x2p
724     then
725         rm -f y.tab.c y.tab.h
726         case "$osname" in
727         posix-bc)
728            # we are using two different yaccs in BS2000 Posix!
729            byacc a2p.y >/dev/null 2>&1
730            ;;
731         *) # e.g. os390
732            yacc  a2p.y >/dev/null 2>&1
733            ;;
734         esac
735         if cmp -s y.tab.c a2p.c
736         then
737             rm -f y.tab.c
738         else
739             echo "a2p.y -> a2p.c" >&2
740             mv -f y.tab.c a2p.c
741             chmod u+w a2p.c
742             sed -e 's/fprintf *( *stderr *,/PerlIO_printf(Perl_debug_log,/g' \
743                 -e 's/y\.tab/a2p/g' a2p.c >a2p.tmp && mv a2p.tmp a2p.c
744             xxx="$xxx a2p.c"
745         fi
746         # In case somebody yacc -d:ed the a2p.y.
747         if test -f y.tab.h
748         then
749             if cmp -s y.tab.h a2p.h
750             then
751                 rm -f y.tab.h
752             else
753                 echo "a2p.h -> a2p.h" >&2
754                 mv -f y.tab.h a2p.h
755                 xxx="$xxx a2p.h"
756             fi
757         fi
758         cd ..
759     fi
760     ;;
761 vmesa)
762     # Do nothing in VM/ESA.
763     ;;
764 *)
765     echo "'$osname' is an EBCDIC system I don't know that well." >&4
766     ;;
767 esac
768     case "$xxx" in
769     '') echo "No parser files were regenerated.  That's okay." >&2 ;;
770     esac
771     ;;
772 esac
773