Inclusive language: Difference between revisions

From Yocto Project
Jump to navigationJump to search
Line 60: Line 60:
!Recommended by
!Recommended by
!Approved name
!Approved name
|-
|Bitbake
|ABORT
|FAIL_BUILD
|Saul Wold
|
|-
|Bitbake
|abort (comment or variable)
|based on context
|Saul Wold
|
|-
|-
|Bitbake
|Bitbake
Line 110: Line 122:
|
|
|
|
|
|-
|core
|abort (comment or variable)
|based on context
|Saul Wold
|
|
|-
|-

Revision as of 15:16, 16 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 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]