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 55DIRDEPS_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! 63DIRDEPS_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 84DIRDEPS += ${DIRDEPS.$o.${_v$o:U}:U} 85.endfor 86DIRDEPS := ${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) 105GENDIRDEPS_FILTER += N$d* 106.elif exists(${SRCTOP}/${d:R}) 107GENDIRDEPS_FILTER += N${d:R}* 108.endif 109.endfor 110.endfor 111.endif 112