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