share/mk/dirdeps-options.mk

   1 # $Id: dirdeps-options.mk,v 1.21 2022/09/06 22:18:45 sjg Exp $
   2 #
   3 #       @(#) Copyright (c) 2018-2022, Simon J. Gerraty
   4 #
   5 #       This file is provided in the hope that it will
   6 #       be of use.  There is absolutely NO WARRANTY.
   7 #       Permission to copy, redistribute or otherwise
   8 #       use this file is hereby granted provided that
   9 #       the above copyright notice and this notice are
  10 #       left intact.
  11 #
  12 #       Please send copies of changes and bug-fixes to:
  13 #       sjg@crufty.net
  14 #
  15
  16 ##
  17 #
  18 # This makefile is used to deal with optional DIRDEPS.
  19 #
  20 # It is to be included by Makefile.depend.options in a
  21 # directory which has DIRDEPS affected by optional features.
  22 # Makefile.depend.options should set DIRDEPS_OPTIONS and
  23 # may also set specific DIRDEPS.* for those options.
  24 #
  25 # If a Makefile.depend.options file exists, it will be included by
  26 # dirdeps.mk and meta.autodep.mk
  27 #
  28 # We include local.dirdeps-options.mk which may also define DIRDEPS.*
  29 # for options.
  30 #
  31 # Thus a directory, that is affected by an option FOO would have
  32 # a Makefile.depend.options that sets
  33 # DIRDEPS_OPTIONS= FOO
  34 # It can also set either/both of
  35 # DIRDEPS.FOO.yes
  36 # DIRDEPS.FOO.no
  37 # to whatever applies for that dir, or it can rely on globals
  38 # set in local.dirdeps-options.mk
  39 # Either way, we will .undef DIRDEPS.* when done.
  40 #
  41 # In some cases the value of MK_FOO might depend on TARGET_SPEC
  42 # so we qualify MK_FOO with .${TARGET_SPEC} and each component
  43 # TARGET_SPEC_VAR (in reverse order) before using MK_FOO.
  44 #
  45 # Because Makefile.depend.options are processed at both level 0 (when
  46 # computing DIRDEPS to build) and higher (when updating
  47 # Makefile.depend* after successful build), it is important that
  48 # all references to TARGET_SPEC_VARs should use the syntax
  49 # ${DEP_${TARGET_SPEC_VAR}:U${TARGET_SPEC_VAR}} to ensure correct
  50 # behavior.
  51 #
  52
  53 # This should have been set by Makefile.depend.options
  54 # before including us
  55 DIRDEPS_OPTIONS ?=
  56
  57 # pickup any DIRDEPS.* we need
  58 .-include <local.dirdeps-options.mk>
  59
  60 .if ${.MAKE.LEVEL} == 0
  61 # :U below avoids potential errors when we :=
  62 # some options can depend on TARGET_SPEC!
  63 DIRDEPS_OPTIONS_QUALIFIER_LIST ?= \
  64         ${DEP_RELDIR} \
  65         ${DEP_TARGET_SPEC:U${TARGET_SPEC}} \
  66         ${TARGET_SPEC_VARSr:U${TARGET_SPEC_VARS}:@v@${DEP_$v:U${$v}}@}
  67 # note that we need to include $o in the variable _o$o
  68 # to ensure correct evaluation.
  69 .for o in ${DIRDEPS_OPTIONS}
  70 .undef _o$o
  71 .undef _v$o
  72 .for x in ${DIRDEPS_OPTIONS_QUALIFIER_LIST:S,^,${DEP_RELDIR}.,} \
  73         ${DIRDEPS_OPTIONS_QUALIFIER_LIST}
  74 #.info MK_$o.$x=${MK_$o.$x:Uundefined}
  75 .if defined(MK_$o.$x)
  76 _o$o ?= MK_$o.$x
  77 _v$o ?= ${MK_$o.$x}
  78 .endif
  79 .endfor
  80 _v$o ?= ${MK_$o}
  81 .if ${_debug_reldir:U0}
  82 .info ${DEP_RELDIR:U${RELDIR}}.${DEP_TARGET_SPEC:U${TARGET_SPEC}}: o=$o ${_o$o:UMK_$o}=${_v$o:U} DIRDEPS += ${DIRDEPS.$o.${_v$o:U}:U}
  83 .endif
  84 DIRDEPS += ${DIRDEPS.$o.${_v$o:U}:U}
  85 .endfor
  86 DIRDEPS := ${DIRDEPS:O:u}
  87 .if ${_debug_reldir:U0}
  88 .info ${DEP_RELDIR:U${RELDIR}}: DIRDEPS=${DIRDEPS}
  89 .endif
  90 # avoid cross contamination
  91 .for o in ${DIRDEPS_OPTIONS}
  92 .undef DIRDEPS.$o.yes
  93 .undef DIRDEPS.$o.no
  94 .undef _o$o
  95 .undef _v$o
  96 .endfor
  97 .else
  98 # whether options are enabled or not,
  99 # we want to filter out the relevant DIRDEPS.*
 100 # we should only be included by meta.autodep.mk
 101 # if dependencies are to be updated
 102 .for o in ${DIRDEPS_OPTIONS}
 103 .for d in ${DIRDEPS.$o.yes} ${DIRDEPS.$o.no}
 104 .if exists(${SRCTOP}/$d)
 105 GENDIRDEPS_FILTER += N$d*
 106 .elif exists(${SRCTOP}/${d:R})
 107 GENDIRDEPS_FILTER += N${d:R}*
 108 .endif
 109 .endfor
 110 .endfor
 111 .endif