Linux 5.8 内核采用包容性术语指南

莱纳斯·托瓦兹 接受了 包含在Linux 5.8内核分支中 变化 代码风格建议。 通过 第三版 关于使用包容性术语的文本,已得到 21 位著名内核开发人员的认可,其中包括 Linux 基金会技术委员会的成员。 被发送给莱纳斯 要求 将更改包含在 5.9 内核中,但他认为没有理由等待下一个接受更改的窗口,并将新文档接受到 5.8 分支中。

与包容性术语相比,第三个版本的文本有所缩短 原提案 (文件被排除 包容性术语.rst 谈论包容性的重要性并解释为什么应该避免有问题的术语)。 只剩下对定义编码风格的文档进行更改。 不建议开发者使用“主/从”和“黑名单/白名单”的组合,以及单独使用“从”一词。 这些建议仅涉及这些术语的新用途。 核心中已存在的指定单词的提及将保持不变。

此外,当需要支持用户空间公开的 API 和 ABI 时,以及更新代码以支持其规范要求使用这些术语的现有硬件或协议时,允许在新代码中使用标记的术语。 在创建基于新规范的实现时,建议尽可能使规范术语与标准 Linux 内核编码保持一致。

建议将“黑名单/白名单”替换为
“拒绝名单/允许名单”或“阻止名单/通行名单”,并且提供以下选项,而不是“主/从”一词:

  • '{主,主} / {辅助,副本,从属}',
  • '{发起者,请求者} / {目标,响应者}',
  • '{控制器,主机} / {设备,工作人员,代理}',
  • '领导者/追随者',
  • “导演/表演者”。

同意变更(Acked-by):

变更审核者:

变更签署(签署者):

更新:Rust 语言开发者已接受 改变,它将代码中的“白名单”替换为“白名单”。 此更改不会影响用户可用的语言选项和结构,只会影响内部组件。

来源: opennet.ru

添加评论