make/subdir.mk

   1 # This file is intended to be included from each subdirectory makefile.
   2 #
   3 # Subdirectory makefiles must define:
   4 #   SubDirs - The subdirectories to traverse.
   5 #
   6 # Subdirectory makefiles may define:
   7 #   ModuleName - The library name for objects in that directory.
   8 #   ObjNames - The objects available in that directory.
   9 #   Implementation - The library configuration the objects should go in (Generic
  10 #                    or Optimized)
  11 #   Dependencies - Any dependences for the object files.
  12 #   OnlyArchs - Only build the objects for the listed archs.
  13 #   OnlyConfigs - Only build the objects for the listed configurations.
  14
  15 ifeq ($(Dir),)
  16   $(error "No Dir variable defined.")
  17 endif
  18
  19 ###
  20 # Include child makefile fragments
  21
  22 # The list of variables which are intended to be overridden in a subdirectory
  23 # makefile.
  24 RequiredSubdirVariables := SubDirs
  25 OptionalSubdirVariables := ModuleName OnlyArchs OnlyConfigs \
  26         ObjNames Implementation Dependencies
  27
  28 # Template: subdir_traverse_template subdir
  29 define subdir_traverse_template
  30 $(call Set,Dir,$(1))
  31 ifneq ($(DEBUGMAKE),)
  32   $$(info MAKE: $(Dir): Processing subdirectory)
  33 endif
  34
  35 # Construct the variable key for this directory.
  36 $(call Set,DirKey,SubDir.$(subst .,,$(subst /,__,$(1))))
  37 $(call Append,SubDirKeys,$(DirKey))
  38 $(call Set,$(DirKey).Dir,$(Dir))
  39
  40 # Reset subdirectory specific variables to sentinel value.
  41 $$(foreach var,$$(RequiredSubdirVariables) $$(OptionalSubdirVariables),\
  42   $$(call Set,$$(var),UNDEFINED))
  43
  44 # Get the subdirectory variables.
  45 include $(1)/Makefile.mk
  46
  47 ifeq ($(DEBUGMAKE),2)
  48 $$(foreach var,$(RequiredSubdirVariables) $(OptionalSubdirVariables),\
  49   $$(if $$(call strneq,UNDEFINED,$$($$(var))), \
  50         $$(info MAKE: $(Dir): $$(var) is defined), \
  51         $$(info MAKE: $(Dir): $$(var) is undefined)))
  52 endif
  53
  54 # Check for undefined required variables, and unset sentinel value from optional
  55 # variables.
  56 $$(foreach var,$(RequiredSubdirVariables),\
  57   $$(if $$(call strneq,UNDEFINED,$$($$(var))),, \
  58         $$(error $(Dir): variable '$$(var)' was not undefined)))
  59 $$(foreach var,$(OptionalSubdirVariables),\
  60   $$(if $$(call strneq,UNDEFINED,$$($$(var))),, \
  61         $$(call Set,$$(var),)))
  62
  63 # Collect all subdirectory variables for subsequent use.
  64 $$(foreach var,$(RequiredSubdirVariables) $(OptionalSubdirVariables),\
  65   $$(call Set,$(DirKey).$$(var),$$($$(var))))
  66
  67 # Recurse.
  68 include make/subdir.mk
  69
  70 # Restore directory variable, for cleanliness.
  71 $$(call Set,Dir,$(1))
  72
  73 ifneq ($(DEBUGMAKE),)
  74   $$(info MAKE: $$(Dir): Done processing subdirectory)
  75 endif
  76 endef
  77
  78 # Evaluate this now so we do not have to worry about order of evaluation.
  79
  80 SubDirsList := $(strip \
  81   $(if $(call streq,.,$(Dir)),\
  82        $(SubDirs),\
  83        $(SubDirs:%=$(Dir)/%)))
  84 ifeq ($(SubDirsList),)
  85 else
  86   ifneq ($(DEBUGMAKE),)
  87     $(info MAKE: Descending into subdirs: $(SubDirsList))
  88   endif
  89
  90   $(foreach subdir,$(SubDirsList),\
  91         $(eval $(call subdir_traverse_template,$(subdir))))
  92 endif