Inclusive language: Difference between revisions
From Yocto Project
Jump to navigationJump to search
No edit summary |
|||
| Line 21: | Line 21: | ||
!whitelist | !whitelist | ||
|- | |- | ||
|denylist | |denylist/disallowlist | ||
|allowlist | |allowlist | ||
|- | |- | ||
| Line 50: | Line 50: | ||
| | | | ||
|- | |- | ||
|core | |||
|blacklist.bbclass (alt) | |||
|forcerecipeskip.bbclass | |||
|Saul | |||
| | |||
|} | |} | ||
| Line 60: | Line 65: | ||
!Recommended by | !Recommended by | ||
!Approved name | !Approved name | ||
!Notes | |||
|- | |- | ||
|Bitbake | |Bitbake | ||
| Line 65: | Line 71: | ||
|FAIL_BUILD | |FAIL_BUILD | ||
|Saul Wold | |Saul Wold | ||
| | |||
| | | | ||
|- | |- | ||
| Line 71: | Line 78: | ||
|based on context | |based on context | ||
|Saul Wold | |Saul Wold | ||
| | |||
| | | | ||
|- | |- | ||
| Line 77: | Line 85: | ||
|BB_ENV_ALLOWLIST | |BB_ENV_ALLOWLIST | ||
| Armin Kuster | | Armin Kuster | ||
| | |||
| | | | ||
|- | |- | ||
| Line 83: | Line 92: | ||
|BB_ENV_EXTRA_ALLOWLIST | |BB_ENV_EXTRA_ALLOWLIST | ||
|Saul Wold | |Saul Wold | ||
| | |||
| | | | ||
|- | |- | ||
|Bitbake | |Bitbake | ||
|BB_HASHCONFIG_WHITELIST | |BB_HASHCONFIG_WHITELIST | ||
| | |||
| | | | ||
| | | | ||
| Line 93: | Line 104: | ||
|Bitbake | |Bitbake | ||
|BB_STAMP_WHITELIST | |BB_STAMP_WHITELIST | ||
| | |||
| | | | ||
| | | | ||
| Line 101: | Line 113: | ||
| | | | ||
| | | | ||
| | |||
| | | | ||
|- | |- | ||
|Bitbake | |Bitbake | ||
|BB_HASHBASE_WHITELIST | |BB_HASHBASE_WHITELIST | ||
| | |||
| | | | ||
| | | | ||
| Line 110: | Line 124: | ||
|Bitbake | |Bitbake | ||
|MULTI_PROVIDER_WHITELIST | |MULTI_PROVIDER_WHITELIST | ||
| | |||
| | | | ||
| | | | ||
| Line 115: | Line 130: | ||
|Bitbake | |Bitbake | ||
|basewhitelist | |basewhitelist | ||
| | |||
| | | | ||
| | | | ||
| Line 120: | Line 136: | ||
|Bitbake | |Bitbake | ||
|taskwhitelist | |taskwhitelist | ||
| | |||
| | | | ||
| | | | ||
| Line 128: | Line 145: | ||
|based on context | |based on context | ||
|Saul Wold | |Saul Wold | ||
| | |||
| | | | ||
|- | |- | ||
|core | |core | ||
|PNBLACKLIST | |PNBLACKLIST | ||
| | |PNFORCESKIP | ||
| | |Saul | ||
| | | | ||
|The usage is a single recipe or PN | |||
|- | |- | ||
|core | |core | ||
|whitelist | |whitelist | ||
| | |allowlist | ||
| | |Saul | ||
| | | | ||
|This could be change based on context | |||
|- | |- | ||
|core | |core | ||
|whitelisted | |whitelisted | ||
| | |allowed | ||
| | |Saul | ||
| | | | ||
|Context sensitve | |||
|- | |- | ||
|core | |core | ||
|whitelisting | |whitelisting | ||
| | |allowing | ||
| | |Saul | ||
| | |||
| | | | ||
|- | |- | ||
|core | |core | ||
|SSTATE_DUPWHITELIST | |SSTATE_DUPWHITELIST | ||
|SSTATE_DUPSKIPLIST | |SSTATE_DUPSKIPLIST/SSTATE_IGN_OVERLAP | ||
| Armin | | Armin/Saul | ||
| | |||
| | | | ||
|- | |- | ||
| Line 164: | Line 187: | ||
|CVE_CHECK_PN_SKIPIST | |CVE_CHECK_PN_SKIPIST | ||
|Armin | |Armin | ||
| | |||
| | | | ||
|- | |- | ||
| Line 170: | Line 194: | ||
|ICECC_USER_CLASS_EXCLUDES | |ICECC_USER_CLASS_EXCLUDES | ||
| Michael Opdenacker | | Michael Opdenacker | ||
| | |||
| | | | ||
|- | |- | ||
| Line 176: | Line 201: | ||
|ICECC_USER_PACKAGE_EXCLUDES | |ICECC_USER_PACKAGE_EXCLUDES | ||
| Michael Opdenacker | | Michael Opdenacker | ||
| | |||
| | | | ||
|- | |- | ||
| Line 182: | Line 208: | ||
|CVE_CHECK_IGNORELIST | |CVE_CHECK_IGNORELIST | ||
| Yuichi Ito | | Yuichi Ito | ||
| | |||
| | | | ||
|- | |- | ||
|core | |core | ||
|SYSROOT_DIRS_BLACKLIST | |SYSROOT_DIRS_BLACKLIST | ||
| | |||
| | | | ||
| | | | ||
| Line 192: | Line 220: | ||
|core | |core | ||
|INHERIT_BLACKLIST | |INHERIT_BLACKLIST | ||
| | |||
| | | | ||
| | | | ||
| Line 198: | Line 227: | ||
|core | |core | ||
|SDK_LOCAL_CONF_BLACKLIST | |SDK_LOCAL_CONF_BLACKLIST | ||
| | |||
| | | | ||
| | | | ||
| Line 204: | Line 234: | ||
|core | |core | ||
|SDK_LOCAL_CONF_WHITELIST | |SDK_LOCAL_CONF_WHITELIST | ||
| | |||
| | | | ||
| | | | ||
| Line 210: | Line 241: | ||
|core | |core | ||
|SDK_INHERIT_BLACKLIST | |SDK_INHERIT_BLACKLIST | ||
| | |||
| | | | ||
| | | | ||
| Line 216: | Line 248: | ||
|core | |core | ||
|WHITELIST_GPL-3.0 | |WHITELIST_GPL-3.0 | ||
| | |||
| | | | ||
| | | | ||
| Line 222: | Line 255: | ||
|core | |core | ||
|TUNEABI_WHITELIST | |TUNEABI_WHITELIST | ||
| | |||
| | | | ||
| | | | ||
| Line 228: | Line 262: | ||
|core | |core | ||
|LICENSE_FLAGS_WHITELIST | |LICENSE_FLAGS_WHITELIST | ||
| | |||
| | | | ||
| | | | ||
| Line 234: | Line 269: | ||
|core | |core | ||
|UNKNOWN_CONFIGURE_WHITELIST | |UNKNOWN_CONFIGURE_WHITELIST | ||
| | |||
| | | | ||
| | | | ||
Revision as of 17:30, 17 December 2021
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/disallowlist | 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 | |
| core | blacklist.bbclass (alt) | forcerecipeskip.bbclass | Saul |
Variables
| Repo | Current name | Suggest rename | Recommended by | Approved name | Notes |
|---|---|---|---|---|---|
| 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 | PNFORCESKIP | Saul | The usage is a single recipe or PN | |
| core | whitelist | allowlist | Saul | This could be change based on context | |
| core | whitelisted | allowed | Saul | Context sensitve | |
| core | whitelisting | allowing | Saul | ||
| core | SSTATE_DUPWHITELIST | SSTATE_DUPSKIPLIST/SSTATE_IGN_OVERLAP | Armin/Saul | ||
| 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]
