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
)
74 LOCALE
:= $(BUILD
)/locale
75 PO_DOMAINS
:= $(BUILD
)/po
/domains
78 LIBRARY_H
= $(BASE
)/buildlib
/library.mak
79 DEBIANDOC_H
= $(BASE
)/buildlib
/debiandoc.mak
80 MANPAGE_H
= $(BASE
)/buildlib
/manpage.mak
81 PROGRAM_H
= $(BASE
)/buildlib
/program.mak
82 PYTHON_H
= $(BASE
)/buildlib
/python.mak
83 COPY_H
= $(BASE
)/buildlib
/copy.mak
84 YODL_MANPAGE_H
= $(BASE
)/buildlib
/yodl_manpage.mak
85 SGML_MANPAGE_H
= $(BASE
)/buildlib
/sgml_manpage.mak
86 FAIL_H
= $(BASE
)/buildlib
/fail.mak
87 PODOMAIN_H
= $(BASE
)/buildlib
/podomain.mak
89 include $(BUILD
)/environment.mak
92 LIBRARY_H
+= $(BASE
)/buildlib
/staticlibrary.mak
96 LIBRARY_H
= $(BASE
)/buildlib
/staticlibrary.mak
99 # Source location control
100 # SUBDIRS specifies sub components of the module that
101 # may be located in subdrictories of the source dir.
102 # This should be declared before including this file
105 # Header file control.
106 # TARGETDIRS indicitates all of the locations that public headers
107 # will be published to.
108 # This should be declared before including this file
112 CPPFLAGS
+= -I
$(INCLUDE
)
115 # Directors to create
118 # Phony rules. Other things hook these by appending to the dependency
120 .PHONY
: headers library
clean veryclean
all binary program doc dirs
121 .PHONY
: maintainer-clean dist-clean
distclean pristine sanity
123 binary
: library program
124 maintainer-clean dist-clean
distclean pristine sanity
: veryclean
125 headers library
clean veryclean program
:
128 echo Very Clean done for
$(SUBDIR
)
130 echo Clean done for
$(SUBDIR
)
132 mkdir
-p
$(patsubst %/,%,$(sort $(MKDIRS
)))
134 # Header file control. We want all published interface headers to go
135 # into the build directory from thier source dirs. We setup some
138 $(INCLUDE
)/%.h
$(addprefix $(INCLUDE
)/,$(addsuffix /%.h
,$(HEADER_TARGETDIRS
))) : %.h
141 # Dependency generation. We want to generate a .d file using gnu cpp.
142 # For GNU systems the compiler can spit out a .d file while it is compiling,
143 # this is specified with the INLINEDEPFLAG. Other systems might have a
144 # makedep program that can be called after compiling, that's illistrated
145 # by the DEPFLAG case.
146 # Compile rules are expected to call this macro after calling the compiler
148 DFILE
= $(DEP
)/$(basename $(@F
)).d
150 DFILE
= $(basename $(@F
)).d
154 sed
-e
"1s/.*:/$(subst /,\\/,$@):/" $(DFILE
) > $(DEP
)/$(@F
).d
155 #sed -e "1s/.*:/$(subst /,\\/,$@):/" $(DEP)/$(basename $(@F)).d > $(DEP)/$(@F).d
156 -rm -f
$(basename $(@F
)).d
161 $(CXX
) $(DEPFLAG
) $(CPPFLAGS
) -o
$@
$<
162 sed
-e
"1s/.*:/$(subst /,\\/,$@):/" $(basename $(@F
)).d
> $(DEP
)/$(@F
).d
163 -rm -f
$(basename $(@F
)).d
171 # Automatic -j support
172 ifeq ($(NUM_PROCS
),1)
178 .EXPORT
: PARALLEL_RUN
180 ifneq ($(NUM_PROCS
),)
181 MAKEFLAGS
+= -j
$(NUM_PROCS
)