buildlib/defaults.mak

   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 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,
  13 #   $($(LOCAL)-VAR)
  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!
  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 explicitly setting the BUILD variable. Make is invoked from
  29 # within the source itself which is much more compatible with compilation
  30 # environments.
  31 ifndef NOISY
  32 .SILENT:
  33 endif
  34
  35 # Search for the build directory
  36 ifdef BUILD
  37 BUILD_POSSIBLE := $(BUILD) $(BASE)/$(BUILD)
  38 else
  39 BUILD_POSSIBLE := $(BASE) $(BASE)/build-$(shell uname -m) $(BASE)/build
  40 endif
  41
  42 BUILDX:= $(foreach i,$(BUILD_POSSIBLE),$(wildcard $(i)/environment.mak*))
  43
  44 ifeq ($(words $(BUILDX)),0)
  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         error-out-and-die
  52 else
  53 error-all/environment.mak:
  54         echo Can not find the build directory in $(BUILD_POSSIBLE) -- use BUILD=
  55         error-out-and-die
  56 endif
  57
  58 # Force include below to come to the error target
  59 BUILDX := error-all
  60 else
  61 BUILDX:= $(patsubst %/,%,$(firstword $(dir $(BUILDX))))
  62 endif
  63
  64 override BUILD := $(BUILDX)
  65
  66 # Base definitions
  67 INCLUDE := $(BUILD)/include
  68 BIN := $(BUILD)/bin
  69 LIB := $(BIN)
  70 OBJ := $(BUILD)/obj/$(SUBDIR)
  71 DEP := $(OBJ)
  72 DOC := $(BUILD)/docs
  73 PO := $(BUILD)/po
  74 LOCALE := $(BUILD)/locale
  75 PO_DOMAINS := $(BUILD)/po/domains
  76
  77 # Module types
  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 PO4A_MANPAGE_H = $(BASE)/buildlib/po4a_manpage.mak
  87 XML_MANPAGE_H = $(BASE)/buildlib/xml_manpage.mak
  88 FAIL_H = $(BASE)/buildlib/fail.mak
  89 PODOMAIN_H = $(BASE)/buildlib/podomain.mak
  90
  91 include $(BUILD)/environment.mak
  92
  93 ifdef STATICLIBS
  94 LIBRARY_H += $(BASE)/buildlib/staticlibrary.mak
  95 endif
  96
  97 ifdef ONLYSTATICLIBS
  98 LIBRARY_H = $(BASE)/buildlib/staticlibrary.mak
  99 endif
 100
 101 # Source location control
 102 # SUBDIRS specifies sub components of the module that
 103 # may be located in subdirectories of the source dir.
 104 # This should be declared before including this file
 105 SUBDIRS+=
 106
 107 # Header file control.
 108 # TARGETDIRS indicates all of the locations that public headers
 109 # will be published to.
 110 # This should be declared before including this file
 111 HEADER_TARGETDIRS+=
 112
 113 # Options
 114 CPPFLAGS+= -I$(INCLUDE)
 115 LDFLAGS+= -L$(LIB)
 116
 117 # Directors to create
 118 MKDIRS := $(BIN)
 119
 120 # Phony rules. Other things hook these by appending to the dependency
 121 # list
 122 .PHONY: headers library clean veryclean all binary program doc dirs
 123 .PHONY: maintainer-clean dist-clean distclean pristine sanity
 124 all: binary doc
 125 binary: library program
 126 maintainer-clean dist-clean distclean pristine sanity: veryclean
 127 headers library clean veryclean program:
 128
 129 veryclean:
 130         echo Very Clean done for $(SUBDIR)
 131 clean:
 132         echo Clean done for $(SUBDIR)
 133 dirs:
 134         mkdir -p $(patsubst %/,%,$(sort $(MKDIRS)))
 135
 136 # Header file control. We want all published interface headers to go
 137 # into the build directory from their source dirs. We setup some
 138 # search paths here
 139 vpath %.h $(SUBDIRS)
 140 $(INCLUDE)/%.h $(addprefix $(INCLUDE)/,$(addsuffix /%.h,$(HEADER_TARGETDIRS))) : %.h
 141         cp $< $@
 142
 143 # Dependency generation. We want to generate a .d file using gnu cpp.
 144 # For GNU systems the compiler can spit out a .d file while it is compiling,
 145 # this is specified with the INLINEDEPFLAG. Other systems might have a
 146 # makedep program that can be called after compiling, that's illustrated
 147 # by the DEPFLAG case.
 148 # Compile rules are expected to call this macro after calling the compiler
 149 ifdef GCC3DEP
 150 DFILE = $(DEP)/$(basename $(@F)).d
 151 else
 152 DFILE = $(basename $(@F)).d
 153 endif
 154 ifdef INLINEDEPFLAG
 155  define DoDep
 156         sed -e "1s/.*:/$(subst /,\\/,$@):/" $(DFILE) > $(DEP)/$(@F).d
 157         #sed -e "1s/.*:/$(subst /,\\/,$@):/" $(DEP)/$(basename $(@F)).d > $(DEP)/$(@F).d
 158         -rm -f $(basename $(@F)).d
 159  endef
 160 else
 161  ifdef DEPFLAG
 162   define DoDep
 163         $(CXX) $(DEPFLAG) $(CPPFLAGS) -o $@ $<
 164         sed -e "1s/.*:/$(subst /,\\/,$@):/" $(basename $(@F)).d > $(DEP)/$(@F).d
 165         -rm -f $(basename $(@F)).d
 166   endef
 167  else
 168   define DoDep
 169   endef
 170  endif
 171 endif
 172
 173 # Automatic -j support
 174 ifeq ($(NUM_PROCS),1)
 175   PARALLEL_RUN=no
 176 endif
 177
 178 # mvo: commented out, lead to build failures in the arch-build target
 179 #ifndef PARALLEL_RUN
 180 # PARALLEL_RUN=yes
 181 # .EXPORT: PARALLEL_RUN
 182 # # handle recursion
 183 # ifneq ($(NUM_PROCS),)
 184 #  MAKEFLAGS += -j $(NUM_PROCS)
 185 # endif
 186 #endif