Docs typo
[users/heiko/exim.git] / src / Makefile
1 # Top-level makefile for Exim; handles creating a build directory with
2 # appropriate links, and then creating and running the main makefile in that
3 # directory.
4
5 # Copyright (c) University of Cambridge, 1995 - 2014
6 # See the file NOTICE for conditions of use and distribution.
7
8 # IRIX make uses the shell that is in the SHELL variable, which often defaults
9 # to csh, so put this in to make it use the Bourne shell. In systems where
10 # /bin/sh is not a Bourne-compatible shell, this line will have to be edited,
11 # or "make" must be called with a different SHELL= setting.
12
13 SHELL=/bin/sh
14 RM_COMMAND=/bin/rm
15
16 # If a build name has not been specified by running this make file via a
17 # command of the form "make build=xxxx", then determine the name of the
18 # operating system and the machine architecture and use that. This does not
19 # provide an override for the OS type and architecture type; they still have
20 # to be used for the OS-specific files. To override them, you can set the
21 # shell variables OSTYPE and ARCHTYPE when running make.
22
23 buildname=$${build:-`$(SHELL) scripts/os-type`-`$(SHELL) scripts/arch-type`}
24
25 # The default target checks for the existence of Local/Makefile, that the main
26 # makefile is built and up-to-date, and then it runs it.
27
28 all: Local/Makefile configure
29         @cd build-$(buildname); $(MAKE) SHELL=$(SHELL) $(MFLAGS)
30
31 Local/Makefile:
32         @echo ""
33         @echo "*** Please create Local/Makefile by copying src/EDITME and making"
34         @echo "*** appropriate changes for your site."
35         @echo ""
36         @test ! -d Local && mkdir Local
37         @false
38
39 # This is separated off so that "make build-directory" can be obeyed on
40 # its own if necessary.
41
42 build-directory:
43         @builddir=build-$(buildname); \
44         case "$$builddir" in *UnKnown*) exit 1;; esac; \
45         $(SHELL) -c "test -d $$builddir -a -r $$builddir/version.c || \
46           (mkdir $$builddir; cd $$builddir; $(SHELL) ../scripts/MakeLinks)";
47
48 checks:
49         $(SHELL) scripts/source_checks
50
51 # The "configure" target ensures that the build directory exists, then arranges
52 # to build the main makefile from inside the build directory, by calling the
53 # Configure-Makefile script. This does its own dependency checking because of
54 # the optional files.
55
56 configure: checks build-directory
57         @cd build-$(buildname); \
58           build=$(build) $(SHELL) ../scripts/Configure-Makefile
59
60 # The "makefile" target forces a rebuild of the makefile (as opposed to
61 # "configure", which doesn't force it).
62
63 makefile: build-directory
64         @cd build-$(buildname); $(RM_COMMAND) -f Makefile; \
65           build=$(build) $(SHELL) ../scripts/Configure-Makefile
66
67 # The installation commands are kept in a separate script, which expects
68 # to be run from inside the build directory.
69
70 install:        all
71                 @cd build-$(buildname); \
72                 build=$(build) $(SHELL) ../scripts/exim_install $(INSTALL_ARG)
73
74 # Tidy-up targets
75
76 clean:; @echo ""; echo '*** "make clean" just removes all .o and .a files'
77         @echo '*** Use "make makefile" to force a rebuild of the makefile'
78         @echo ""
79         cd build-$(buildname); \
80         $(RM_COMMAND) -f *.o lookups/*.o lookups/*.a auths/*.o auths/*.a \
81         routers/*.o routers/*.a transports/*.o transports/*.a \
82         pdkim/*.o pdkim/*.a
83
84 clean_exim:; cd build-$(buildname); \
85          $(RM_COMMAND) -f *.o lookups/*.o lookups/*.a auths/*.o auths/*.a \
86         routers/*.o routers/*.a transports/*.o transports/*.a lookups/*.so
87
88 distclean:; $(RM_COMMAND) -rf build-* cscope*
89
90 cscope.files: FRC
91         echo "-q" > $@
92         echo "-p3" >> $@
93         find src Local OS exim_monitor -name "*.[cshyl]" -print \
94                     -o -name "os.h*" -print \
95                     -o -name "*akefile*" -print \
96                     -o -name EDITME -print >> $@
97         ls OS/* >> $@
98
99 FRC:
100
101 # End of top-level makefile