Better document the difference between a block and a script.

[p5sagit/p5-mst-13.2.git] / Makefile.SH

diff --git a/Makefile.SH b/Makefile.SH
index 97c9925..6c031f6 100644 (file)
--- a/Makefile.SH
+++ b/Makefile.SH
@@ -209,7 +209,7 @@ FIRSTMAKEFILE = $firstmakefile
 # Any special object files needed by this architecture, e.g. os2/os2.obj
 ARCHOBJS = $archobjs
 
-.SUFFIXES: .c \$(OBJ_EXT)
+.SUFFIXES: .c \$(OBJ_EXT) .i .s
 
 # grrr
 SHELL = $sh
@@ -227,7 +227,9 @@ TRNL = '$trnl'
 ## In the following dollars and backticks do not need the extra backslash.
 $spitshell >>Makefile <<'!NO!SUBS!'
 
-CCCMD = `sh $(shellflags) cflags $(LIBPERL) $@`
+CCCMD    = `sh $(shellflags) cflags $(LIBPERL) $@`
+
+CCCMDSRC = `sh $(shellflags) cflags $(LIBPERL) $<`
 
 private = preplibrary lib/ExtUtils/Miniperl.pm lib/Config.pm
 
@@ -288,6 +290,14 @@ lintflags = -hbvxac
 .c$(OBJ_EXT):
        $(CCCMD) $(PLDLFLAGS) $*.c
 
+.c.i:
+       $(CCCMDSRC) -E $*.c > $*.i
+
+.c.s:
+       $(CCCMDSRC) -S $*.c
+
+.PHONY: all compile translators utilities
+
 all: $(FIRSTMAKEFILE) miniperl extra.pods $(private) $(public) $(dynamic_ext) $(nonxs_ext)
        @echo " ";
        @echo " Everything is up to date. 'make test' to run test suite."
@@ -310,6 +320,7 @@ utilities:  miniperl lib/Config.pm $(plextract) lib/lib.pm FORCE
 
 # Phony target to force checking subdirectories.
 # Apparently some makes require an action for the FORCE target.
+.PHONY: FORCE
 FORCE:
        @sh -c true
 !NO!SUBS!
@@ -564,6 +575,7 @@ perl.gprof: /usr/bin/gprof perl.gprof.config
 # build also the full Perl and therefore the real big Makefile:
 # usually one should manually explicitly issue the below command.
 
+.PHONY: microperl
 microperl:
        $(MAKE) -f Makefile.micro
 
@@ -590,6 +602,7 @@ sperl$(OBJ_EXT): perl.c $(h)
 # We have to call our ./makedir because Ultrix 4.3 make can't handle the line
 #      test -d lib/auto || mkdir lib/auto
 #
+.PHONY: preplibrary
 preplibrary: miniperl lib/Config.pm lib/lib.pm lib/re.pm
        @sh ./makedir lib/auto
        @echo " AutoSplitting perl library"
@@ -629,6 +642,9 @@ extra.pods: miniperl
        done
        -@test -f vms/perlvms.pod && cd pod && $(LNS) ../vms/perlvms.pod perlvms.pod && cd .. && echo "pod/perlvms.pod" >> extra.pods
 
+.PHONY: install install-strip install-all install-verbose install-silent \
+       no-install install.perl install.man installman install.html installhtml
+
 install-strip:
        $(MAKE) STRIPFLAGS=-s install
 
@@ -678,6 +694,8 @@ install.html: all installhtml
 # to run with precisely the same version of byacc as I use.  You
 # normally shouldn't remake perly.[ch].
 
+.PHONY: check_byacc run_byacc
+
 check_byacc:
        @$(BYACC) -V 2>&1 | grep 'version 1\.8\.2'
 
@@ -763,6 +781,8 @@ AUTOGEN_FILES = keywords.h opcode.h opnames.h pp_proto.h pp.sym proto.h \
                ext/ByteLoader/byterun.c ext/B/B/Asmdata.pm regnodes.h \
                warnings.h lib/warnings.pm
 
+.PHONY: regen_headers regen_pods regen_all
+
 regen_headers: FORCE
        -$(CHMOD_W) $(AUTOGEN_FILES)
        -perl keywords.pl
@@ -799,6 +819,10 @@ s_dummy $(static_ext):     miniperl preplibrary $(DYNALOADER) FORCE
 n_dummy $(nonxs_ext):  miniperl preplibrary $(DYNALOADER) FORCE
        @$(LDLIBPTH) sh ext/util/make_ext nonxs $@ MAKE=$(MAKE) LIBPERL_A=$(LIBPERL)
 
+.PHONY: clean _tidy _mopup _cleaner1 _cleaner2 \
+       realclean _realcleaner clobber _clobber \
+       distclean veryclean _verycleaner
+
 clean:         _tidy _mopup
 
 realclean:     _realcleaner _mopup
@@ -874,6 +898,7 @@ _verycleaner:
 # If the source file has a /*NOSTRICT*/ somewhere, ignore the lint message
 # for that spot.
 
+.PHONY: lint
 lint: $(c)
        lint $(lintflags) $(defs) perly.c $(c) > perl.fuzz
 
@@ -890,6 +915,7 @@ config.h: config_h.SH config.sh
        $(SHELL) config_h.SH
 
 # When done, touch perlmain.c so that it doesn't get remade each time.
+.PHONY: depend
 depend: makedepend
        sh ./makedepend MAKE=$(MAKE)
        - test -s perlmain.c && touch perlmain.c
@@ -899,6 +925,13 @@ depend: makedepend
 makedepend: makedepend.SH config.sh
        sh ./makedepend.SH
 
+.PHONY: test check test_prep _test_prep \
+       test_tty test-tty _test_tty test_notty test-notty _test_notty \
+       utest ucheck test.utf8 check.utf8 \
+       test.third check.third utest.third ucheck.third test_notty.third \
+       test.deparse test_notty.deparse \
+       minitest
+
 # Cannot delegate rebuilding of t/perl to make
 # to allow interlaced test and minitest
 
@@ -970,12 +1003,15 @@ minitest: miniperl lib/re.pm
        @echo "You may see some irrelevant test failures if you have been unable"
        @echo "to build lib/Config.pm."
        - cd t && (rm -f perl$(EXE_EXT); $(LNS) ../miniperl$(EXE_EXT) perl$(EXE_EXT)) \
-               && $(LDLIBPTH) ./perl TEST base/*.t comp/*.t cmd/*.t run/*.t io/*.t op/*.t pragma/*.t </dev/tty
+               && $(LDLIBPTH) ./perl TEST base/*.t comp/*.t cmd/*.t run/*.t io/*.t op/*.t </dev/tty
 
 # Handy way to run perlbug -ok without having to install and run the
 # installed perlbug. We don't re-run the tests here - we trust the user.
 # Please *don't* use this unless all tests pass.
 # If you want to report test failures, use "make nok" instead.
+
+.PHONY: ok okfile oknack okfilenack nok nokfile noknack nokfilenack
+
 ok:    utilities
        $(LDLIBPTH) ./perl -Ilib utils/perlbug -ok -s '(UNINSTALLED)'
 
@@ -1000,6 +1036,8 @@ noknack:  utilities
 nokfilenack:   utilities
        $(LDLIBPTH) ./perl -Ilib utils/perlbug -nok -s '(UNINSTALLED)' -F perl.nok -A
 
+.PHONY: clist hlist shlist pllist
+
 clist: $(c)
        echo $(c) | tr ' ' $(TRNL) >.clist
 
@@ -1015,14 +1053,18 @@ pllist: $(pl)
 Makefile: Makefile.SH ./config.sh
        $(SHELL) Makefile.SH
 
+.PHONY: distcheck
 distcheck: FORCE
        perl '-MExtUtils::Manifest=&fullcheck' -e 'fullcheck()'
 
+.PHONY: elc
 elc:   emacs/cperl-mode.elc
 
 emacs/cperl-mode.elc: emacs/cperl-mode.el
        -cd emacs; emacs -batch -q -no-site-file -f batch-byte-compile cperl-mode.el
 
+.PHONY: etags ctags tags
+
 etags: TAGS
 
 TAGS: emacs/cperl-mode.elc