Commit | Line | Data |
---|---|---|
094a497d AL |
1 | # -*- make -*- |
2 | ||
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. | |
8 | ||
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, | |
13 | # $($(LOCAL)-VAR) | |
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' | |
46976ca4 AL |
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! | |
094a497d AL |
24 | |
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 | |
30 | # environments. | |
93bf083d | 31 | ifndef NOISY |
118a5e95 | 32 | .SILENT: |
93bf083d | 33 | endif |
094a497d | 34 | |
118a5e95 AL |
35 | # Search for the build directory |
36 | ifdef BUILD | |
93641593 | 37 | BUILD_POSSIBLE := $(BUILD) $(BASE)/$(BUILD) |
118a5e95 | 38 | else |
f40e3a64 | 39 | BUILD_POSSIBLE := $(BASE) $(BASE)/build-$(shell uname -m) $(BASE)/build |
118a5e95 AL |
40 | endif |
41 | ||
93641593 | 42 | BUILDX:= $(foreach i,$(BUILD_POSSIBLE),$(wildcard $(i)/environment.mak*)) |
118a5e95 | 43 | |
93641593 | 44 | ifeq ($(words $(BUILDX)),0) |
101030ab AL |
45 | |
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. | |
51 | else | |
52 | error-all/environment.mak: | |
118a5e95 | 53 | echo Can't find the build directory in $(BUILD_POSSIBLE) -- use BUILD= |
094a497d AL |
54 | endif |
55 | ||
101030ab AL |
56 | # Force include below to come to the error target |
57 | BUILDX := error-all | |
58 | else | |
59 | BUILDX:= $(patsubst %/,%,$(firstword $(dir $(BUILDX)))) | |
60 | endif | |
61 | ||
93641593 AL |
62 | override BUILD := $(BUILDX) |
63 | ||
094a497d AL |
64 | # Base definitions |
65 | INCLUDE := $(BUILD)/include | |
66 | BIN := $(BUILD)/bin | |
67 | LIB := $(BIN) | |
3164dff9 | 68 | OBJ := $(BUILD)/obj/$(SUBDIR) |
094a497d | 69 | DEP := $(OBJ) |
93bf083d | 70 | DOC := $(BUILD)/docs |
094a497d AL |
71 | |
72 | # Module types | |
ac966541 AL |
73 | LIBRARY_H = $(BASE)/buildlib/library.mak |
74 | DEBIANDOC_H = $(BASE)/buildlib/debiandoc.mak | |
75 | MANPAGE_H = $(BASE)/buildlib/manpage.mak | |
1164783d | 76 | PROGRAM_H = $(BASE)/buildlib/program.mak |
c3c459fc | 77 | COPY_H = $(BASE)/buildlib/copy.mak |
8a9ec519 | 78 | YODL_MANPAGE_H = $(BASE)/buildlib/yodl_manpage.mak |
094a497d | 79 | |
e1b1ae50 AL |
80 | ifdef STATICLIBS |
81 | LIBRARY_H += $(BASE)/buildlib/staticlibrary.mak | |
82 | endif | |
83 | ||
c1a22377 AL |
84 | ifdef ONLYSTATICLIBS |
85 | LIBRARY_H = $(BASE)/buildlib/staticlibrary.mak | |
86 | endif | |
87 | ||
094a497d AL |
88 | # Source location control |
89 | # SUBDIRS specifies sub components of the module that | |
90 | # may be located in subdrictories of the source dir. | |
91 | # This should be declared before including this file | |
92 | SUBDIRS+= | |
93 | ||
94 | # Header file control. | |
95 | # TARGETDIRS indicitates all of the locations that public headers | |
96 | # will be published to. | |
97 | # This should be declared before including this file | |
98 | HEADER_TARGETDIRS+= | |
99 | ||
100 | # Options | |
118a5e95 | 101 | include $(BUILD)/environment.mak |
1164783d AL |
102 | CPPFLAGS+= -I$(INCLUDE) |
103 | LDFLAGS+= -L$(LIB) | |
094a497d AL |
104 | |
105 | # Phony rules. Other things hook these by appending to the dependency | |
106 | # list | |
ac966541 | 107 | .PHONY: headers library clean veryclean all binary program doc |
93641593 | 108 | .PHONY: maintainer-clean dist-clean distclean pristine sanity |
ac966541 | 109 | all: binary doc |
094a497d | 110 | binary: library program |
9031a668 | 111 | maintainer-clean dist-clean distclean pristine sanity: veryclean |
094a497d AL |
112 | headers library clean veryclean program: |
113 | ||
f00ce0ae AL |
114 | veryclean: |
115 | echo Very Clean done for $(SUBDIR) | |
116 | clean: | |
117 | echo Clean done for $(SUBDIR) | |
118 | ||
094a497d AL |
119 | # Header file control. We want all published interface headers to go |
120 | # into the build directory from thier source dirs. We setup some | |
121 | # search paths here | |
122 | vpath %.h $(SUBDIRS) | |
123 | $(INCLUDE)/%.h $(addprefix $(INCLUDE)/,$(addsuffix /%.h,$(HEADER_TARGETDIRS))) : %.h | |
124 | cp $< $@ | |
125 | ||
126 | # Dependency generation. We want to generate a .d file using gnu cpp. | |
127 | # For GNU systems the compiler can spit out a .d file while it is compiling, | |
128 | # this is specified with the INLINEDEPFLAG. Other systems might have a | |
129 | # makedep program that can be called after compiling, that's illistrated | |
130 | # by the DEPFLAG case. | |
131 | # Compile rules are expected to call this macro after calling the compiler | |
6f27a7fc | 132 | ifdef INLINEDEPFLAG |
094a497d | 133 | define DoDep |
e1b1ae50 | 134 | sed -e "1s/.*:/$(subst /,\\/,$@):/" $(basename $(@F)).d > $(DEP)/$(@F).d |
094a497d AL |
135 | -rm -f $(basename $(@F)).d |
136 | endef | |
137 | else | |
138 | ifdef DEPFLAG | |
139 | define DoDep | |
140 | $(CXX) $(DEPFLAG) $(CPPFLAGS) -o $@ $< | |
e1b1ae50 | 141 | sed -e "1s/.*:/$(subst /,\\/,$@):/" $(basename $(@F)).d > $(DEP)/$(@F).d |
094a497d AL |
142 | -rm -f $(basename $(@F)).d |
143 | endef | |
144 | else | |
145 | define DoDep | |
146 | endef | |
147 | endif | |
148 | endif | |
f43579d1 AL |
149 | |
150 | ifeq ($(NUM_PROCS),1) | |
151 | PARALLEL_RUN=no | |
152 | endif | |
153 | ||
154 | ifndef PARALLEL_RUN | |
155 | PARALLEL_RUN=yes | |
156 | .EXPORT: PARALLEL_RUN | |
157 | ifneq ($(NUM_PROCS),) | |
158 | # handle recursion | |
159 | MAKEFLAGS += -j $(NUM_PROCS) | |
160 | endif | |
161 | endif |