Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
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
+20
+20
Documentation/process/coding-style.rst
+20
Documentation/process/coding-style.rst
···
319
319
problem, which is called the function-growth-hormone-imbalance syndrome.
320
320
See chapter 6 (Functions).
321
321
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.
322
342
323
343
5) Typedefs
324
344
-----------