Skip to content

Commit 49decdd

Browse files
committed
Merge tag 'inclusive-terminology' of git://git.kernel.org/pub/scm/linux/kernel/git/djbw/linux
Pull coding style terminology documentation from Dan Williams: "The discussion has tapered off as well as the incoming ack, review, and sign-off tags. I did not see a reason to wait for the next merge window" * tag 'inclusive-terminology' of git://git.kernel.org/pub/scm/linux/kernel/git/djbw/linux: CodingStyle: Inclusive Terminology
2 parents 5a76489 + a5f526e commit 49decdd

File tree

1 file changed

+20
-0
lines changed

1 file changed

+20
-0
lines changed

Documentation/process/coding-style.rst

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -319,6 +319,26 @@ If you are afraid to mix up your local variable names, you have another
319319
problem, which is called the function-growth-hormone-imbalance syndrome.
320320
See chapter 6 (Functions).
321321

322+
For symbol names and documentation, avoid introducing new usage of
323+
'master / slave' (or 'slave' independent of 'master') and 'blacklist /
324+
whitelist'.
325+
326+
Recommended replacements for 'master / slave' are:
327+
'{primary,main} / {secondary,replica,subordinate}'
328+
'{initiator,requester} / {target,responder}'
329+
'{controller,host} / {device,worker,proxy}'
330+
'leader / follower'
331+
'director / performer'
332+
333+
Recommended replacements for 'blacklist/whitelist' are:
334+
'denylist / allowlist'
335+
'blocklist / passlist'
336+
337+
Exceptions for introducing new usage is to maintain a userspace ABI/API,
338+
or when updating code for an existing (as of 2020) hardware or protocol
339+
specification that mandates those terms. For new specifications
340+
translate specification usage of the terminology to the kernel coding
341+
standard where possible.
322342

323343
5) Typedefs
324344
-----------

0 commit comments

Comments
 (0)