Received: by 2002:a05:6902:102b:0:0:0:0 with SMTP id x11csp490155ybt; Mon, 6 Jul 2020 14:34:58 -0700 (PDT) X-Google-Smtp-Source: ABdhPJx76POVXiqBR5f7bYcowKe+cv9Y/gh9euVE3yKk3Gdyjxy6zB+t/PUYPQ4vxVNnyoNATYEa X-Received: by 2002:a05:6402:1a54:: with SMTP id bf20mr57464761edb.69.1594071298718; Mon, 06 Jul 2020 14:34:58 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1594071298; cv=none; d=google.com; s=arc-20160816; b=YPwkjr0AytukAe7fEDti9vNwTXbA25NBLsxPOTSTXNf9qbChhI2o0xMKEs9eRpxqj5 MFLM+OFpPBxs718au/HMFk7Nl7/cpOrdqawzh4SdbWFS409NDXvAFd72NEQhtEnUrYde 7bMVl62tDLw10haCTVQiUrhoElUwB3JR7kEjHNI1p5Ejiw2NqaQ6y0CEILd8V3jUQMiO c62IdZkbNllfgqKAeEVdEASMLRDdu4A25Mk3jrgPdcTHc6mxI/SSufpEDLZF5RZcmXUt muuHHXW38ceiBM8iHUGpzUjpqKo4kZCikP9b0/83kDhiaGeZatzkxoWTZDEwH1QNdxpZ kx7w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding :content-language:in-reply-to:mime-version:user-agent:date :message-id:subject:autocrypt:from:references:cc:to:dkim-signature; bh=Qf/6BQZYwY/jWPNtXOCd4ny1xvRkK/T4D4tthHHp42s=; b=hYk/DLKvvcW9zN2qs8vriSjWvXKIx40zj1iZz8i/yxLC/iJEWKWeo8gzK83xycjxpV 2cH24QoCRrBHK7oDlCEY1cHzB9Nnodbx4KnE4mua1kMB9xA5LH23mazqES/JzumoId23 hp8s1H6nf7yCIJY5V1k3Hl9GlNGpep10TGzklJwYXqMnZ4QFwFT/sreL+knifR7nUV20 TFuhEX2v/iJPEdCgxtRzWzp5UHujhqoF4AOt4oQdg+BY0FwDX2owcuOKfIKptjofuLzd OeGdYtZ+u1s5F/aC8lQ/4WQZEe6T5vvy95fCESetQWnxrMp+jXGv0zYTrWvqmM1jHOe9 SFIQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b=FJjSt2tr; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id c3si13370217edr.308.2020.07.06.14.34.35; Mon, 06 Jul 2020 14:34:58 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b=FJjSt2tr; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726591AbgGFVdf (ORCPT + 99 others); Mon, 6 Jul 2020 17:33:35 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:36890 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726001AbgGFVdd (ORCPT ); Mon, 6 Jul 2020 17:33:33 -0400 Received: from mail-wm1-x342.google.com (mail-wm1-x342.google.com [IPv6:2a00:1450:4864:20::342]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 05146C061755 for ; Mon, 6 Jul 2020 14:33:32 -0700 (PDT) Received: by mail-wm1-x342.google.com with SMTP id 17so43517039wmo.1 for ; Mon, 06 Jul 2020 14:33:32 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=to:cc:references:from:autocrypt:subject:message-id:date:user-agent :mime-version:in-reply-to:content-language:content-transfer-encoding; bh=Qf/6BQZYwY/jWPNtXOCd4ny1xvRkK/T4D4tthHHp42s=; b=FJjSt2trDmchefSX36+GdUYFsuYhIg7dEd7MoE3Tx1Mdx0huZea64x5H8OasEGjaiE vtqmBwV0KR/ZkejF5f0QG1rwpv+bQwl8Lq7eV7fir/MtjQ/5GoqtpivKvjXOEzwNUorR Dki8SRwFRScFn4HTWJ74B+o5gR8R97PSw5ERHXbnSQHfiAErZ6+Z9VjBvKVnZ/sIEwAz N91arDROQ+RlQQICqJtMbi1cvfZX95xFRCKVdrcR7AqxN5Yh9+7Py8bQ6Nscq3l4OBsJ 30BNUMpOaQHOMusqiI+MjvRQeVu9GWlkTPNzd6MKXSeiAL6TxxVEqTS1PmmZK5OF5LvD T+Mg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:to:cc:references:from:autocrypt:subject :message-id:date:user-agent:mime-version:in-reply-to :content-language:content-transfer-encoding; bh=Qf/6BQZYwY/jWPNtXOCd4ny1xvRkK/T4D4tthHHp42s=; b=uoC0g3eMJCGY9eXztiNmq0x69N/DNrm4JMfc5vEssvOR5038IRGpkvsEq/iwZz7UcD EQ/xjvHvQG0ulSeagZUVYnrJVa9Ro8MJYh/jg7m9437JyJBhrm+OvNQXOvabs6rPzGat oI7f+DhFAqP5S6qnEtJcHYJUtEcLoDs4XLaGRYA/W3Sm57LJVaMy/lkHlAw0YlJpnnLB UWsXBVmUHSBDs0FoOXmZGbkO4kHIExkxwbkAe6+ade4A1XutVq9MA4FrY9F5FSI78JNn gVHVjm/nSUMhoM7zS14MtGFhI6Dc1XnouuiEEHDLD5YfC+uS8w2riH6b34B8tbSwYpQA gZAw== X-Gm-Message-State: AOAM531dRc2mKCnV57QbM658NEtKEjnp1lP9rbSUgxdsXcFxuwe7RJp4 Cx+qr65SQcIydXP4Uy3ql40MzVQz66E= X-Received: by 2002:a1c:a4c6:: with SMTP id n189mr1008511wme.173.1594071211268; Mon, 06 Jul 2020 14:33:31 -0700 (PDT) Received: from [192.168.43.52] ([5.100.193.69]) by smtp.gmail.com with ESMTPSA id t16sm27541413wru.9.2020.07.06.14.33.29 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Mon, 06 Jul 2020 14:33:30 -0700 (PDT) To: Dan Williams Cc: torvalds@linux-foundation.org, Jonathan Corbet , Kees Cook , Chris Mason , Greg Kroah-Hartman , ksummit-discuss@lists.linuxfoundation.org, tech-board-discuss@lists.linuxfoundation.org, linux-kernel@vger.kernel.org References: <159389297140.2210796.13590142254668787525.stgit@dwillia2-desk3.amr.corp.intel.com> From: Pavel Begunkov Autocrypt: addr=asml.silence@gmail.com; prefer-encrypt=mutual; keydata= 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 bA== Subject: Re: [PATCH] CodingStyle: Inclusive Terminology Message-ID: <1cceba0f-c8ad-260d-9a09-5417bee32d50@gmail.com> Date: Tue, 7 Jul 2020 00:31:49 +0300 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.3.0 MIME-Version: 1.0 In-Reply-To: <159389297140.2210796.13590142254668787525.stgit@dwillia2-desk3.amr.corp.intel.com> Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On 04/07/2020 23:02, Dan Williams wrote: > Recent events have prompted a Linux position statement on inclusive > terminology. Given that Linux maintains a coding-style and its own > idiomatic set of terminology here is a proposal to answer the call to > replace non-inclusive terminology. > > Cc: Jonathan Corbet > Cc: Kees Cook > Signed-off-by: Chris Mason > Signed-off-by: Greg Kroah-Hartman > Signed-off-by: Dan Williams > --- > Documentation/process/coding-style.rst | 12 ++++ > Documentation/process/inclusive-terminology.rst | 64 +++++++++++++++++++++++ > Documentation/process/index.rst | 1 > 3 files changed, 77 insertions(+) > create mode 100644 Documentation/process/inclusive-terminology.rst > > diff --git a/Documentation/process/coding-style.rst b/Documentation/process/coding-style.rst > index 2657a55c6f12..4b15ab671089 100644 > --- a/Documentation/process/coding-style.rst > +++ b/Documentation/process/coding-style.rst > @@ -319,6 +319,18 @@ 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, avoid introducing new usage of the words 'slave' and > +'blacklist'. Recommended replacements for 'slave' are: 'secondary', > +'subordinate', 'replica', 'responder', 'follower', 'proxy', or > +'performer'. Recommended replacements for blacklist are: 'blocklist' or > +'denylist'. "Subordinate" means that they are unequal, and inequality is a big issue. This should be forbidden as well. And what with "secondary"? Are you implying that one better than another? That's shouting that people from the second world countries don't have right to be included, this can't be good. Are you trying to exclude me? That deeply hurts me, don't you care? How about killing all words that mean "ownership" or "owning" then? And what with that "kill"? It's everywhere, and it definitely means killing a person. That's one meaning at least... but we don't care about other interpretations, do we? ... > +Word choice and developer efficiency > +==================================== > + > +Why does any software project go through the trouble of developing a > +document like :ref:`process/coding-style.rst `? It does so > +because a common coding style maximizes the efficiency of both > +maintainers and developers. Developers learn common design patterns and > +idiomatic expressions while maintainers can spot deviations from those > +norms. Even non-compliant whitespace is considered a leading indicator > +to deeper problems in a patchset. Coding style violations are known to > +take a maintainer "out of the zone" of reviewing code. Maintainers are > +also sensitive to word choice across specifications and often choose to > +deploy Linux terminology to replace non-idiomatic word-choice in a > +specification. > + > +Non-inclusive terminology has that same distracting effect which is why > +it is a style issue for Linux, it injures developer efficiency. Code styles also exist to not think about things that doesn't matter, as well as terminologies do -- you see it, and the meaning is apparent. And that betrays the whole idea when you replace well-known terms with some random words. Well, if you're trying to point people what to say and how to think, could you please __at least__ be consistent? That would be really nice. Let me outline -- discrimination is an issue. And creating a common vocabulary can be pretty useful. But instead of it being helpful, the only thing I see here is ill-conceived and pretty arrogant essay. -- Pavel Begunkov