Linux kernel now recommends politically correct terms

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

内容简介: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

-----------


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

查看所有标签

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

网页设计创意书(卷2)

网页设计创意书(卷2)

麦克尼尔 / 图灵编辑部 / 人民邮电 / 2012-1 / 49.00元

《网页设计创意书(卷2)》是《网页设计创意书》的卷2,但并非其简单补充,而是作者基于近几年网站发展新趋势的再创作。《网页设计创意书(卷2)》先讲解了如何从他人的优秀设计中寻找灵感,接着阐述了重点、对比、平衡、对齐等网站设计的基本原则,然后将网站按类型、设计元素、风格和主题、结构样式和结构元素分类,并分章介绍了每一类的设计技巧。《网页设计创意书(卷2)》语言简练,结合作者精挑细选的网站实例,通俗易懂......一起来看看 《网页设计创意书(卷2)》 这本书的介绍吧!

在线进制转换器
在线进制转换器

各进制数互转换器

随机密码生成器
随机密码生成器

多种字符组合密码

HEX HSV 转换工具
HEX HSV 转换工具

HEX HSV 互换工具