share/mk/bsd.subdir.mk

   1 #       from: @(#)bsd.subdir.mk 5.9 (Berkeley) 2/1/91
   2 # $FreeBSD$
   3 #
   4 # The include file <bsd.subdir.mk> contains the default targets
   5 # for building subdirectories.
   6 #
   7 # For all of the directories listed in the variable SUBDIRS, the
   8 # specified directory will be visited and the target made. There is
   9 # also a default target which allows the command "make subdir" where
  10 # subdir is any directory listed in the variable SUBDIRS.
  11 #
  12 #
  13 # +++ variables +++
  14 #
  15 # DISTRIBUTION  Name of distribution. [base]
  16 #
  17 # SUBDIR        A list of subdirectories that should be built as well.
  18 #               Each of the targets will execute the same target in the
  19 #               subdirectories. SUBDIR.yes is automatically appeneded
  20 #               to this list.
  21 #
  22 # +++ targets +++
  23 #
  24 #       distribute:
  25 #               This is a variant of install, which will
  26 #               put the stuff into the right "distribution".
  27 #
  28 #       See SUBDIR_TARGETS for list of targets that will recurse.
  29 #
  30 #       Targets defined in STANDALONE_SUBDIR_TARGETS will always be ran
  31 #       with SUBDIR_PARALLEL and will not respect .WAIT or SUBDIR_DEPEND_
  32 #       values.
  33 #
  34 #       SUBDIR_TARGETS and STANDALONE_SUBDIR_TARGETS can be appended to
  35 #       via make.conf or src.conf.
  36 #
  37
  38 .if !target(__<bsd.subdir.mk>__)
  39 __<bsd.subdir.mk>__:
  40
  41 SUBDIR_TARGETS+= \
  42                 all all-man buildconfig buildfiles buildincludes \
  43                 checkdpadd clean cleandepend cleandir cleanilinks \
  44                 cleanobj depend distribute files includes installconfig \
  45                 installfiles installincludes realinstall lint maninstall \
  46                 manlint obj objlink tags \
  47
  48 # Described above.
  49 STANDALONE_SUBDIR_TARGETS+= \
  50                 obj check checkdpadd clean cleandepend cleandir \
  51                 cleanilinks cleanobj installconfig \
  52
  53 .include <bsd.init.mk>
  54
  55 .if !defined(NEED_SUBDIR)
  56 .if ${.MAKE.LEVEL} == 0 && ${MK_DIRDEPS_BUILD} == "yes" && !empty(SUBDIR) && !(make(clean*) || make(destroy*))
  57 .include <meta.subdir.mk>
  58 # ignore this
  59 _SUBDIR:
  60 .endif
  61 .endif
  62
  63 DISTRIBUTION?=  base
  64 .if !target(distribute)
  65 distribute: .MAKE
  66 .for dist in ${DISTRIBUTION}
  67         ${_+_}cd ${.CURDIR}; \
  68             ${MAKE} install -DNO_SUBDIR DESTDIR=${DISTDIR}/${dist} SHARED=copies
  69 .endfor
  70 .endif
  71
  72 # Convenience targets to run 'build${target}' and 'install${target}' when
  73 # calling 'make ${target}'.
  74 .for __target in files includes
  75 .if !target(${__target})
  76 ${__target}:    build${__target} install${__target}
  77 .ORDER:         build${__target} install${__target}
  78 .endif
  79 .endfor
  80
  81 # Make 'install' supports a before and after target.  Actual install
  82 # hooks are placed in 'realinstall'.
  83 .if !target(install)
  84 .for __stage in before real after
  85 .if !target(${__stage}install)
  86 ${__stage}install:
  87 .endif
  88 .endfor
  89 install:        beforeinstall realinstall afterinstall
  90 .ORDER:         beforeinstall realinstall afterinstall
  91 .endif
  92
  93 # SUBDIR recursing may be disabled for MK_DIRDEPS_BUILD
  94 .if !target(_SUBDIR)
  95
  96 .if defined(SUBDIR)
  97 SUBDIR:=${SUBDIR} ${SUBDIR.yes}
  98 SUBDIR:=${SUBDIR:u}
  99 .endif
 100
 101 # Subdir code shared among 'make <subdir>', 'make <target>' and SUBDIR_PARALLEL.
 102 _SUBDIR_SH=     \
 103                 if test -d ${.CURDIR}/$${dir}.${MACHINE_ARCH}; then \
 104                         dir=$${dir}.${MACHINE_ARCH}; \
 105                 fi; \
 106                 ${ECHODIR} "===> ${DIRPRFX}$${dir} ($${target})"; \
 107                 cd ${.CURDIR}/$${dir}; \
 108                 ${MAKE} $${target} DIRPRFX=${DIRPRFX}$${dir}/
 109
 110 _SUBDIR: .USEBEFORE
 111 .if defined(SUBDIR) && !empty(SUBDIR) && !defined(NO_SUBDIR)
 112         @${_+_}target=${.TARGET:realinstall=install}; \
 113             for dir in ${SUBDIR:N.WAIT}; do ( ${_SUBDIR_SH} ); done
 114 .endif
 115
 116 ${SUBDIR:N.WAIT}: .PHONY .MAKE
 117         ${_+_}@target=all; \
 118             dir=${.TARGET}; \
 119             ${_SUBDIR_SH};
 120
 121 .for __target in ${SUBDIR_TARGETS}
 122 # Only recurse on directly-called targets.  I.e., don't recurse on dependencies
 123 # such as 'install' becoming {before,real,after}install, just recurse
 124 # 'install'.  Despite that, 'realinstall' is special due to ordering issues
 125 # with 'afterinstall'.
 126 .if make(${__target}) || (${__target} == realinstall && make(install))
 127 # Can ordering be skipped for this and SUBDIR_PARALLEL forced?
 128 .if ${STANDALONE_SUBDIR_TARGETS:M${__target}}
 129 _is_standalone_target=  1
 130 SUBDIR:=        ${SUBDIR:N.WAIT}
 131 .else
 132 _is_standalone_target=  0
 133 .endif
 134 .if defined(SUBDIR_PARALLEL) || ${_is_standalone_target} == 1
 135 __subdir_targets=
 136 .for __dir in ${SUBDIR}
 137 .if ${__dir} == .WAIT
 138 __subdir_targets+= .WAIT
 139 .else
 140 __subdir_targets+= ${__target}_subdir_${__dir}
 141 __deps=
 142 .if ${_is_standalone_target} == 0
 143 .for __dep in ${SUBDIR_DEPEND_${__dir}}
 144 __deps+= ${__target}_subdir_${__dep}
 145 .endfor
 146 .endif
 147 ${__target}_subdir_${__dir}: .PHONY .MAKE ${__deps}
 148 .if !defined(NO_SUBDIR)
 149         @${_+_}target=${__target:realinstall=install}; \
 150             dir=${__dir}; \
 151             ${_SUBDIR_SH};
 152 .endif
 153 .endif
 154 .endfor # __dir in ${SUBDIR}
 155 ${__target}: ${__subdir_targets}
 156 .else
 157 ${__target}: _SUBDIR
 158 .endif  # SUBDIR_PARALLEL || _is_standalone_target
 159 .endif  # make(${__target})
 160 .endfor # __target in ${SUBDIR_TARGETS}
 161
 162 .endif  # !target(_SUBDIR)
 163
 164 # Ensure all targets exist
 165 .for __target in ${SUBDIR_TARGETS}
 166 .if !target(${__target})
 167 ${__target}:
 168 .endif
 169 .endfor
 170
 171 .endif