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 | 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 | 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 | Current name | Suggest rename | Recommended by | Approved name |
|---|---|---|---|---|
| oe | 0001-lxdm.conf.in-blacklist-root-for-release-images.patch | 0001-lxdm.conf.in-deny-root-for-release-images.patch | Saul Wold | |
| oe | 022-RH-Remove-the-property-blacklist-exception-builtin.patch | 022-RH-Remove-the-default-property-exception-builtin.patch | Saul Wold | |
| core | 11_tcpd_blacklist.patch | 11_tcpd_blocklist.patch | Saul Wold | |
| core | mount.blacklist | mount.blocklist | Saul Wold | |
| meta-integrity | /files/ima_signing_blacklist | /files/ima_signing_blocklist | Saul Wold | |
| efi-secure-boot | Fix-the-wrong-dependency-for-blacklist.esl.patch | Fix-the-wrong-dependency-esl-file.patch | Saul Wold |
Notes
Some upstream references: [1][ Linux kernel]
