3 # This file configures the default environment for the make system
4 # The way it works is fairly simple, each module is defined in it's
5 # own *.mak file. It expects a set of variables to be set to values
6 # for it to operate as expected. When included the module generates
7 # the requested rules based on the contents of its control variables.
9 # This works out very well and allows a good degree of flexability.
10 # To accomidate some of the features we introduce the concept of
11 # local variables. To do this we use the 'Computed Names' feature of
12 # gmake. Each module declares a LOCAL scope and access it with,
14 # This works very well but it is important to rembember that within
15 # a rule the LOCAL var is unavailble, it will have to be constructed
16 # from the information in the rule invokation. For stock rules like
17 # clean this is simple, we use a local clean rule called clean/$(LOCAL)
18 # and then within the rule $(@F) gets back $(LOCAL)! Other rules will
19 # have to use some other mechanism (filter perhaps?) The reason such
20 # lengths are used is so that each directory can contain several 'instances'
21 # of any given module. I notice that the very latest gmake has the concept
22 # of local variables for rules. It is possible this feature in conjunction
23 # with the generated names will provide a very powerfull solution indeed!
25 # A build directory is used by default, all generated items get put into
26 # there. However unlike automake this is not done with a VPATH build
27 # (vpath builds break the distinction between #include "" and #include <>)
28 # but by explicly setting the BUILD variable. Make is invoked from
29 # within the source itself which is much more compatible with compilation
35 # Search for the build directory
37 BUILD_POSSIBLE
:= $(BUILD
) $(BASE
)/$(BUILD
)
39 BUILD_POSSIBLE
:= $(BASE
) $(BASE
)/build-
$(shell uname
-m
) $(BASE
)/build
42 BUILDX
:= $(foreach i
,$(BUILD_POSSIBLE
),$(wildcard $(i
)/environment.mak
*))
44 ifeq ($(words $(BUILDX
)),0)
46 # Check for a busted wildcard function. We use this function in several
47 # places, it must work.
48 ifeq ($(words $(wildcard *)),0)
49 error-all
/environment.mak
:
50 echo You have a broken version of GNU Make
- upgrade.
53 error-all
/environment.mak
:
54 echo Can not find the build directory in
$(BUILD_POSSIBLE
) -- use BUILD
=
58 # Force include below to come to the error target
61 BUILDX
:= $(patsubst %/,%,$(firstword $(dir $(BUILDX
))))
64 override BUILD
:= $(BUILDX
)
67 INCLUDE
:= $(BUILD
)/include
70 OBJ
:= $(BUILD
)/obj
/$(SUBDIR
)
75 LIBRARY_H
= $(BASE
)/buildlib
/library.mak
76 DEBIANDOC_H
= $(BASE
)/buildlib
/debiandoc.mak
77 MANPAGE_H
= $(BASE
)/buildlib
/manpage.mak
78 PROGRAM_H
= $(BASE
)/buildlib
/program.mak
79 PYTHON_H
= $(BASE
)/buildlib
/python.mak
80 COPY_H
= $(BASE
)/buildlib
/copy.mak
81 YODL_MANPAGE_H
= $(BASE
)/buildlib
/yodl_manpage.mak
82 SGML_MANPAGE_H
= $(BASE
)/buildlib
/sgml_manpage.mak
83 FAIL_H
= $(BASE
)/buildlib
/fail.mak
85 include $(wildcard $(BUILD
)/environment.
*mak
)
88 LIBRARY_H
+= $(BASE
)/buildlib
/staticlibrary.mak
92 LIBRARY_H
= $(BASE
)/buildlib
/staticlibrary.mak
95 # Source location control
96 # SUBDIRS specifies sub components of the module that
97 # may be located in subdrictories of the source dir.
98 # This should be declared before including this file
101 # Header file control.
102 # TARGETDIRS indicitates all of the locations that public headers
103 # will be published to.
104 # This should be declared before including this file
108 CPPFLAGS
+= -I
$(INCLUDE
)
111 # Directors to create
114 # Phony rules. Other things hook these by appending to the dependency
116 .PHONY
: headers library
clean veryclean
all binary program doc dirs
117 .PHONY
: maintainer-clean dist-clean
distclean pristine sanity
119 binary
: library program
120 maintainer-clean dist-clean
distclean pristine sanity
: veryclean
121 headers library
clean veryclean program
:
124 echo Very Clean done for
$(SUBDIR
)
126 echo Clean done for
$(SUBDIR
)
128 mkdir
-p
$(patsubst %/,%,$(sort $(MKDIRS
)))
130 # Header file control. We want all published interface headers to go
131 # into the build directory from thier source dirs. We setup some
134 $(INCLUDE
)/%.h
$(addprefix $(INCLUDE
)/,$(addsuffix /%.h
,$(HEADER_TARGETDIRS
))) : %.h
137 # Dependency generation. We want to generate a .d file using gnu cpp.
138 # For GNU systems the compiler can spit out a .d file while it is compiling,
139 # this is specified with the INLINEDEPFLAG. Other systems might have a
140 # makedep program that can be called after compiling, that's illistrated
141 # by the DEPFLAG case.
142 # Compile rules are expected to call this macro after calling the compiler
145 sed
-e
"1s/.*:/$(subst /,\\/,$@):/" $(basename $(@F
)).d
> $(DEP
)/$(@F
).d
146 -rm -f
$(basename $(@F
)).d
151 $(CXX
) $(DEPFLAG
) $(CPPFLAGS
) -o
$@
$<
152 sed
-e
"1s/.*:/$(subst /,\\/,$@):/" $(basename $(@F
)).d
> $(DEP
)/$(@F
).d
153 -rm -f
$(basename $(@F
)).d
161 # Automatic -j support
162 ifeq ($(NUM_PROCS
),1)
168 .EXPORT
: PARALLEL_RUN
170 ifneq ($(NUM_PROCS
),)
171 MAKEFLAGS
+= -j
$(NUM_PROCS
)