Inclusive language

Inclusive Language

First time topic was explored on mailing list. https://lists.openembedded.org/g/openembedded-architecture/topic/inclusive_language_summary/75821819

This is an attempt to collate Inclusive Language for OpenEmbedded and the Yocto Project in regards to code.

For reference: https://inclusivenaming.org/word-lists/overview/

Game play

If a BB variable has a local assignment, the rename should be transitive. Example: BB_HASHBASE_WHITELIST is changed to BB_HASHBASE_ALLOWLIST, then self.basewhitelist would become self.baseallowlist

Add an offending name in one of the three tables below. If you have a suggested replacement, please add. If the translation is approved, that will be noted in the same row. Approval process: TBD

Recommendations

Recommended replacements for 'blacklist/whitelist' are:

blacklist	whitelist
denylist	allowlist
blocklist	passlist
excludes or excludelist	includes or includelist

Exceptions

Exceptions for introducing new usage is limited upstream sources outside the control of The Yocto Project and OpenEmbedded.

Classes

Repo	Current name	Suggest rename	Recommended by	Approved name
core	blacklist.bbclass	excludelist.bbclass	Armin

Variables

Repo	Current name	Suggest rename	Recommended by	Approved name
Bitbake	ABORT	FAIL_BUILD	Saul Wold
Bitbake	abort (comment or variable)	based on context	Saul Wold
Bitbake	BB_ENV_WHITELIST	BB_ENV_ALLOWLIST	Armin Kuster
Bitbake	BB_ENV_EXTRAWHITE	BB_ENV_EXTRA_ALLOWLIST	Saul Wold
Bitbake	BB_HASHCONFIG_WHITELIST
Bitbake	BB_STAMP_WHITELIST
Bitbake	BB_SETSCENE_ENFORCE_WHITELIST
Bitbake	BB_HASHBASE_WHITELIST
Bitbake	MULTI_PROVIDER_WHITELIST
Bitbake	basewhitelist
Bitbake	taskwhitelist
core	abort (comment or variable)	based on context	Saul Wold
core	PNBLACKLIST	PNSKIPLIST	Armin
core	whitelist	excludelist	Armin
core	whitelisted	excluded	Armin
core	whitelisting	excluding	Armin
core	SSTATE_DUPWHITELIST	SSTATE_DUPSKIPLIST	Armin
core	CVE_CHECK_PN_WHITELIST	CVE_CHECK_PN_SKIPIST	Armin
core	ICECC_USER_CLASS_BL	ICECC_USER_CLASS_EXCLUDES	Michael Opdenacker
core	ICECC_USER_PACKAGE_BL	ICECC_USER_PACKAGE_EXCLUDES	Michael Opdenacker
core	CVE_CHECK_WHITELIST	CVE_CHECK_IGNORELIST	Yuichi Ito
core	SYSROOT_DIRS_BLACKLIST
core	INHERIT_BLACKLIST
core	SDK_LOCAL_CONF_BLACKLIST
core	SDK_LOCAL_CONF_WHITELIST
core	SDK_INHERIT_BLACKLIST
core	WHITELIST_GPL-3.0
core	TUNEABI_WHITELIST
core	LICENSE_FLAGS_WHITELIST
core	UNKNOWN_CONFIGURE_WHITELIST

Functions

Repo	Current name	Suggest rename	Recommended by	Approved name
Bitabke	test_setscenewhitelist

Patch Files

Repo	Recipe	Current name	Suggest rename	Recommended by	Approved name
core	tcp-wrappers	11_tcpd_blacklist.patch	11_tcpd_blocklist.patch	Saul Wold
core	udev-extraconf	mount.blacklist	mount.disallow	Saul Wold
oe	lxdm	0001-lxdm.conf.in-blacklist-root-for-release-images.patch	0001-lxdm.conf.in-deny-root-for-release-images.patch	Saul Wold
oe	multipath-tools	022-RH-Remove-the-property-blacklist-exception-builtin.patch	022-RH-Remove-the-default-property-exception-builtin.patch	Saul Wold
oe	mozjs	0001-Cargo.toml-do-not-abort-on-panic.patch	0001-Cargo.toml-do-not-exit-on-panic.patch	Saul Wold
oe	mozjs	0004-Cargo.toml-do-not-abort-on-panic.patch	0004-Cargo.toml-do-not-exit-on-panic.patch	Saul Wold
meta-integrity	files	ima_signing_blacklist	ima_signing_blocklist	Saul Wold
meta-efi-secure-boot	efitools	Fix-the-wrong-dependency-for-blacklist.esl.patch	Fix-the-wrong-dependency-esl-file.patch	Saul Wold
meta-raspberrypi	gstreamer1.0-omx	0005-Don-t-abort-gst_omx_video_dec_set_format-if-there-s-.patch	0005-Don-t-return-gst_omx_video_dec_set_format-if-there-s-.patch	Saul Wold

Notes

Some upstream references: [1][ Linux kernel]