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 flexibility.
10 # To accommodate 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 remember that within
15 # a rule the LOCAL var is unavailable, it will have to be constructed
16 # from the information in the rule invocation. 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 powerful 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 explicitly 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 DOCBOOK_H
= $(BASE
)/buildlib
/docbook.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 PO4A_MANPAGE_H
= $(BASE
)/buildlib
/po4a_manpage.mak
85 FAIL_H
= $(BASE
)/buildlib
/fail.mak
86 PODOMAIN_H
= $(BASE
)/buildlib
/podomain.mak
88 include $(BUILD
)/environment.mak
91 LIBRARY_H
+= $(BASE
)/buildlib
/staticlibrary.mak
95 LIBRARY_H
= $(BASE
)/buildlib
/staticlibrary.mak
98 # Source location control
99 # SUBDIRS specifies sub components of the module that
100 # may be located in subdirectories of the source dir.
101 # This should be declared before including this file
104 # Header file control.
105 # TARGETDIRS indicates all of the locations that public headers
106 # will be published to.
107 # This should be declared before including this file
111 CPPFLAGS
+= -I
$(INCLUDE
)
114 # Directors to create
117 # Phony rules. Other things hook these by appending to the dependency
119 .PHONY
: headers library
clean veryclean
all binary program doc dirs
120 .PHONY
: maintainer-clean dist-clean
distclean pristine sanity
122 binary
: library program
123 maintainer-clean dist-clean
distclean pristine sanity
: veryclean
124 startup headers library
clean veryclean program
test update-po manpages docbook
:
127 echo Very Clean done for
$(SUBDIR
)
129 echo Clean done for
$(SUBDIR
)
131 mkdir
-p
$(patsubst %/,%,$(sort $(MKDIRS
)))
133 # Header file control. We want all published interface headers to go
134 # into the build directory from their source dirs. We setup some
137 $(INCLUDE
)/%.h
$(addprefix $(INCLUDE
)/,$(addsuffix /%.h
,$(HEADER_TARGETDIRS
))) : %.h
140 # Dependency generation. We want to generate a .d file using gnu cpp.
141 # For GNU systems the compiler can spit out a .d file while it is compiling,
142 # this is specified with the INLINEDEPFLAG. Other systems might have a
143 # makedep program that can be called after compiling, that's illustrated
144 # by the DEPFLAG case.
145 # Compile rules are expected to call this macro after calling the compiler
147 DFILE
= $(DEP
)/$(basename $(@F
)).d
149 DFILE
= $(basename $(@F
)).d
153 sed
-e
"1s/.*:/$(subst /,\\/,$@):/" $(DFILE
) > $(DEP
)/$(@F
).d
154 #sed -e "1s/.*:/$(subst /,\\/,$@):/" $(DEP)/$(basename $(@F)).d > $(DEP)/$(@F).d
155 -rm -f
$(basename $(@F
)).d
160 $(CXX
) $(DEPFLAG
) $(CPPFLAGS
) -o
$@
$<
161 sed
-e
"1s/.*:/$(subst /,\\/,$@):/" $(basename $(@F
)).d
> $(DEP
)/$(@F
).d
162 -rm -f
$(basename $(@F
)).d
170 # Automatic -j support
171 ifeq ($(NUM_PROCS
),1)
179 ifneq ($(NUM_PROCS
),)
180 MAKEFLAGS
+= -j
$(NUM_PROCS
)