Saturday, July 11, 2020

Linux kernel now recommends politically correct terms

@@ -319,6 +319,26 @@ If you are afraid to mix up your local variable names, you have another

problem, which is called the function-growth-hormone-imbalance syndrome.

See chapter 6 (Functions).

+For symbol names and documentation, avoid introducing new usage of

+'master / slave' (or 'slave' independent of 'master') and 'blacklist /

+whitelist'.

+

+Recommended replacements for 'master / slave' are:

+ '{primary,main} / {secondary,replica,subordinate}'

+ '{initiator,requester} / {target,responder}'

+ '{controller,host} / {device,worker,proxy}'

+ 'leader / follower'

+ 'director / performer'

+

+Recommended replacements for 'blacklist/whitelist' are:

+ 'denylist / allowlist'

+ 'blocklist / passlist'

+

+Exceptions for introducing new usage is to maintain a userspace ABI/API,

+or when updating code for an existing (as of 2020) hardware or protocol

+specification that mandates those terms. For new specifications

+translate specification usage of the terminology to the kernel coding

+standard where possible.

5) Typedefs

-----------



from Hacker News https://ift.tt/32ehsZc

No comments:

Post a Comment

Note: Only a member of this blog may post a comment.