freebsd-skq/share/mk/bsd.mkopt.mk

#
# $FreeBSD$
#
# Generic mechanism to deal with WITH and WITHOUT options and turn
# them into MK_ options.
#
# For each option FOO in __DEFAULT_YES_OPTIONS, MK_FOO is set to
# "yes", unless WITHOUT_FOO is defined, in which case it is set to
# "no".
#
# For each option FOO in __DEFAULT_NO_OPTIONS, MK_FOO is set to "no",
# unless WITH_FOO is defined, in which case it is set to "yes".
#
# If both WITH_FOO and WITHOUT_FOO are defined, WITHOUT_FOO wins and
# MK_FOO is set to "no" regardless of which list it was in.
#
# Both __DEFAULT_YES_OPTIONS and __DEFAULT_NO_OPTIONS are undef'd
# after all this processing, allowing this file to be included
# multiple times with different lists.
#
# Other parts of the build system will set BROKEN_OPTIONS to a list
# of options that are broken on this platform. This will not be unset
# before returning. Clients are expected to always += this variable.
#
# Users should generally define WITH_FOO or WITHOUT_FOO, but the build
# system should use MK_FOO={yes,no} when it needs to override the
# user's desires or default behavior.
#

#
# MK_* options which default to "yes".
#
.for var in ${__DEFAULT_YES_OPTIONS}
.if !defined(MK_${var})
.if defined(WITHOUT_${var})			# WITHOUT always wins
MK_${var}:=	no
.else
MK_${var}:=	yes
.endif
.else
.if ${MK_${var}} != "yes" && ${MK_${var}} != "no"
.error "Illegal value for MK_${var}: ${MK_${var}}"
.endif
.endif # !defined(MK_${var})
.endfor
.undef __DEFAULT_YES_OPTIONS

#
# MK_* options which default to "no".
#
.for var in ${__DEFAULT_NO_OPTIONS}
.if !defined(MK_${var})
.if defined(WITH_${var}) && !defined(WITHOUT_${var}) # WITHOUT always wins
MK_${var}:=	yes
.else
MK_${var}:=	no
.endif
.else
.if ${MK_${var}} != "yes" && ${MK_${var}} != "no"
.error "Illegal value for MK_${var}: ${MK_${var}}"
.endif
.endif # !defined(MK_${var})
.endfor
.undef __DEFAULT_NO_OPTIONS

#
# MK_* options which are always no, usually because they are
# unsupported/badly broken on this architecture.
#
.for var in ${BROKEN_OPTIONS}
MK_${var}:=	no
.endfor

.for vv in ${__DEFAULT_DEPENDENT_OPTIONS}
.if defined(WITH_${vv:H}) && defined(WITHOUT_${vv:H})
MK_${vv:H}?= no
.elif defined(WITH_${vv:H})
MK_${vv:H}?= yes
.elif defined(WITHOUT_${vv:H})
MK_${vv:H}?= no
.else
MK_${vv:H}?= ${MK_${vv:T}}
.endif
MK_${vv:H}:= ${MK_${vv:H}}
.endfor
.undef __DEFAULT_DEPENDENT_OPTIONS
Move the generic part of bsd.opts.mk into bsd.mkopts.mk to allow for the WITH/WITHOUT_FOO -> MK_FOO={yes,no} stuff to be used elsewhere. 2014-04-18 17:04:26 +00:00			`#`
			`# $FreeBSD$`
			`#`
[1] Make WITHOUT_FOO alway trump WITH_FOO, regardless of the system default. This restores more of the historical expectations that were broken when we started disallowing both WITH_FOO and WITHOUT_FOO to be defined. [2] Document this new behavior, and improve the documentation in general here. Submitted by: sjg@ [1]. 2014-05-05 22:02:48 +00:00			`# Generic mechanism to deal with WITH and WITHOUT options and turn`
			`# them into MK_ options.`
Move the generic part of bsd.opts.mk into bsd.mkopts.mk to allow for the WITH/WITHOUT_FOO -> MK_FOO={yes,no} stuff to be used elsewhere. 2014-04-18 17:04:26 +00:00			`#`
fix spelling of DEFAULT in comments... 2014-10-22 06:53:55 +00:00			`# For each option FOO in __DEFAULT_YES_OPTIONS, MK_FOO is set to`
[1] Make WITHOUT_FOO alway trump WITH_FOO, regardless of the system default. This restores more of the historical expectations that were broken when we started disallowing both WITH_FOO and WITHOUT_FOO to be defined. [2] Document this new behavior, and improve the documentation in general here. Submitted by: sjg@ [1]. 2014-05-05 22:02:48 +00:00			`# "yes", unless WITHOUT_FOO is defined, in which case it is set to`
			`# "no".`
Move the generic part of bsd.opts.mk into bsd.mkopts.mk to allow for the WITH/WITHOUT_FOO -> MK_FOO={yes,no} stuff to be used elsewhere. 2014-04-18 17:04:26 +00:00			`#`
fix spelling of DEFAULT in comments... 2014-10-22 06:53:55 +00:00			`# For each option FOO in __DEFAULT_NO_OPTIONS, MK_FOO is set to "no",`
[1] Make WITHOUT_FOO alway trump WITH_FOO, regardless of the system default. This restores more of the historical expectations that were broken when we started disallowing both WITH_FOO and WITHOUT_FOO to be defined. [2] Document this new behavior, and improve the documentation in general here. Submitted by: sjg@ [1]. 2014-05-05 22:02:48 +00:00			`# unless WITH_FOO is defined, in which case it is set to "yes".`
Move the generic part of bsd.opts.mk into bsd.mkopts.mk to allow for the WITH/WITHOUT_FOO -> MK_FOO={yes,no} stuff to be used elsewhere. 2014-04-18 17:04:26 +00:00			`#`
[1] Make WITHOUT_FOO alway trump WITH_FOO, regardless of the system default. This restores more of the historical expectations that were broken when we started disallowing both WITH_FOO and WITHOUT_FOO to be defined. [2] Document this new behavior, and improve the documentation in general here. Submitted by: sjg@ [1]. 2014-05-05 22:02:48 +00:00			`# If both WITH_FOO and WITHOUT_FOO are defined, WITHOUT_FOO wins and`
			`# MK_FOO is set to "no" regardless of which list it was in.`
			`#`
			`# Both __DEFAULT_YES_OPTIONS and __DEFAULT_NO_OPTIONS are undef'd`
			`# after all this processing, allowing this file to be included`
			`# multiple times with different lists.`
			`#`
Add support for specifying unsupported / broken options that override any defaults or user specified actions on the command line. This would be useful for specifying features that are always broken or that cannot make sense on a specific architecture, like ACPI on pc98 or EISA on !i386 (!x86 usage of EISA is broken and there's no supported hardware that could have it in any event). Any items in BROKEN_OPTIONS are forced to "no" regardless of other settings. Clients are expected change BROKEN_OPTIONS with +=. It will not be unset, so other parts of the build system can have visibility into the options that are broken on this platform, though this should be very rare. Differential Revision: https://reviews.freebsd.org/D2009 2015-03-12 03:57:00 +00:00			`# Other parts of the build system will set BROKEN_OPTIONS to a list`
			`# of options that are broken on this platform. This will not be unset`
			`# before returning. Clients are expected to always += this variable.`
			`#`
[1] Make WITHOUT_FOO alway trump WITH_FOO, regardless of the system default. This restores more of the historical expectations that were broken when we started disallowing both WITH_FOO and WITHOUT_FOO to be defined. [2] Document this new behavior, and improve the documentation in general here. Submitted by: sjg@ [1]. 2014-05-05 22:02:48 +00:00			`# Users should generally define WITH_FOO or WITHOUT_FOO, but the build`
			`# system should use MK_FOO={yes,no} when it needs to override the`
			`# user's desires or default behavior.`
			`#`

			`#`
			`# MK_* options which default to "yes".`
Move the generic part of bsd.opts.mk into bsd.mkopts.mk to allow for the WITH/WITHOUT_FOO -> MK_FOO={yes,no} stuff to be used elsewhere. 2014-04-18 17:04:26 +00:00			`#`
			`.for var in ${__DEFAULT_YES_OPTIONS}`
			`.if !defined(MK_${var})`
[1] Make WITHOUT_FOO alway trump WITH_FOO, regardless of the system default. This restores more of the historical expectations that were broken when we started disallowing both WITH_FOO and WITHOUT_FOO to be defined. [2] Document this new behavior, and improve the documentation in general here. Submitted by: sjg@ [1]. 2014-05-05 22:02:48 +00:00			`.if defined(WITHOUT_${var}) # WITHOUT always wins`
Move the generic part of bsd.opts.mk into bsd.mkopts.mk to allow for the WITH/WITHOUT_FOO -> MK_FOO={yes,no} stuff to be used elsewhere. 2014-04-18 17:04:26 +00:00			`MK_${var}:= no`
			`.else`
			`MK_${var}:= yes`
			`.endif`
Enforce that MK_foo options shall be either "yes" or "no" and nothing else. 2015-02-09 16:03:55 +00:00			`.else`
			`.if ${MK_${var}} != "yes" && ${MK_${var}} != "no"`
			`.error "Illegal value for MK_${var}: ${MK_${var}}"`
Move the generic part of bsd.opts.mk into bsd.mkopts.mk to allow for the WITH/WITHOUT_FOO -> MK_FOO={yes,no} stuff to be used elsewhere. 2014-04-18 17:04:26 +00:00			`.endif`
Enforce that MK_foo options shall be either "yes" or "no" and nothing else. 2015-02-09 16:03:55 +00:00			`.endif # !defined(MK_${var})`
Move the generic part of bsd.opts.mk into bsd.mkopts.mk to allow for the WITH/WITHOUT_FOO -> MK_FOO={yes,no} stuff to be used elsewhere. 2014-04-18 17:04:26 +00:00			`.endfor`
			`.undef __DEFAULT_YES_OPTIONS`

			`#`
			`# MK_* options which default to "no".`
			`#`
			`.for var in ${__DEFAULT_NO_OPTIONS}`
			`.if !defined(MK_${var})`
Spell always the more traditional way. 2014-05-09 04:49:43 +00:00			`.if defined(WITH_${var}) && !defined(WITHOUT_${var}) # WITHOUT always wins`
Move the generic part of bsd.opts.mk into bsd.mkopts.mk to allow for the WITH/WITHOUT_FOO -> MK_FOO={yes,no} stuff to be used elsewhere. 2014-04-18 17:04:26 +00:00			`MK_${var}:= yes`
			`.else`
			`MK_${var}:= no`
			`.endif`
Enforce that MK_foo options shall be either "yes" or "no" and nothing else. 2015-02-09 16:03:55 +00:00			`.else`
			`.if ${MK_${var}} != "yes" && ${MK_${var}} != "no"`
			`.error "Illegal value for MK_${var}: ${MK_${var}}"`
Move the generic part of bsd.opts.mk into bsd.mkopts.mk to allow for the WITH/WITHOUT_FOO -> MK_FOO={yes,no} stuff to be used elsewhere. 2014-04-18 17:04:26 +00:00			`.endif`
Enforce that MK_foo options shall be either "yes" or "no" and nothing else. 2015-02-09 16:03:55 +00:00			`.endif # !defined(MK_${var})`
Move the generic part of bsd.opts.mk into bsd.mkopts.mk to allow for the WITH/WITHOUT_FOO -> MK_FOO={yes,no} stuff to be used elsewhere. 2014-04-18 17:04:26 +00:00			`.endfor`
			`.undef __DEFAULT_NO_OPTIONS`
Add support for specifying unsupported / broken options that override any defaults or user specified actions on the command line. This would be useful for specifying features that are always broken or that cannot make sense on a specific architecture, like ACPI on pc98 or EISA on !i386 (!x86 usage of EISA is broken and there's no supported hardware that could have it in any event). Any items in BROKEN_OPTIONS are forced to "no" regardless of other settings. Clients are expected change BROKEN_OPTIONS with +=. It will not be unset, so other parts of the build system can have visibility into the options that are broken on this platform, though this should be very rare. Differential Revision: https://reviews.freebsd.org/D2009 2015-03-12 03:57:00 +00:00
			`#`
			`# MK_* options which are always no, usually because they are`
			`# unsupported/badly broken on this architecture.`
			`#`
			`.for var in ${BROKEN_OPTIONS}`
			`MK_${var}:= no`
			`.endfor`
Add support for dependent options Reviewed by: imp 2015-06-06 01:18:28 +00:00
			`.for vv in ${__DEFAULT_DEPENDENT_OPTIONS}`
			`.if defined(WITH_${vv:H}) && defined(WITHOUT_${vv:H})`
			`MK_${vv:H}?= no`
			`.elif defined(WITH_${vv:H})`
			`MK_${vv:H}?= yes`
			`.elif defined(WITHOUT_${vv:H})`
			`MK_${vv:H}?= no`
			`.else`
			`MK_${vv:H}?= ${MK_${vv:T}}`
			`.endif`
Appy := to dependent opts once value determined. This is needed to fix output from 'make showconfig' 2015-06-22 19:01:09 +00:00			`MK_${vv:H}:= ${MK_${vv:H}}`
Add support for dependent options Reviewed by: imp 2015-06-06 01:18:28 +00:00			`.endfor`
			`.undef __DEFAULT_DEPENDENT_OPTIONS`