Linux kernel now recommends politically correct terms

栏目: IT技术 · 发布时间: 6年前

内容简介:Merge tag 'inclusive-terminology' of git://git.kernel.org/pub/scm/linux/kernel/git/djbw/linuxPull 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

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

Diffstat

-rw-r--r-- Documentation/process/coding-style.rst 20

1 files changed, 20 insertions, 0 deletions

diff --git a/Documentation/process/coding-style.rst b/Documentation/process/coding-style.rst

index 2657a55c6f12..1bee6f8affdb 100644

--- a/ Documentation/process/coding-style.rst

+++ b/ Documentation/process/coding-style.rst

@@ -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

-----------


以上就是本文的全部内容,希望本文的内容对大家的学习或者工作能带来一定的帮助,也希望大家多多支持 码农网

查看所有标签

本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们

程序员修炼之道(影印版)

程序员修炼之道(影印版)

Andrew Hunt、David Thomas / 中国电力出版社 / 2003-8-1 / 39.00

本书直击编程陈地,穿过了软件开发中日益增长的规范和技术藩篱,对核心过程进行了审视——即根据需求,创建用户乐于接受的、可工作和易维护的代码。本书包含的内容从个人责任到职业发展,直至保持代码灵活和易于改编重用的架构技术。从本书中将学到防止软件变质、消除复制知识的陷阱、编写灵活、动态和易适应的代码、避免出现相同的设计、用契约、断言和异常对代码进行防护等内容。一起来看看 《程序员修炼之道(影印版)》 这本书的介绍吧!

URL 编码/解码
URL 编码/解码

URL 编码/解码

HSV CMYK 转换工具
HSV CMYK 转换工具

HSV CMYK互换工具