From patchwork Sat Mar 4 04:19:31 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Wang, Wei W" X-Patchwork-Id: 64158 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:5915:0:0:0:0:0 with SMTP id v21csp794379wrd; Fri, 3 Mar 2023 22:14:07 -0800 (PST) X-Google-Smtp-Source: AK7set/Sa1wC4F9ZEGeekkF3K3Na/caa6G1poNKsG24JNR4EFup9oi/v2kIoabEuBZKYD96xCSpi X-Received: by 2002:a17:907:80e:b0:885:6a2e:f941 with SMTP id wv14-20020a170907080e00b008856a2ef941mr5308684ejb.54.1677910447643; Fri, 03 Mar 2023 22:14:07 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1677910447; cv=none; d=google.com; s=arc-20160816; b=t6DT8P/pyEniat9OClmNuVmlZYoEFIv86xTgLskIBufo6QmaIwmOSZCiCKDGv0TULe NyjddVDZzhelFVWRQ18hoKm7Mq2sgRODwZBOvCSsZnePpq8VspAGIL1oSGzNuPWpqRPv hdO3hqA+yTOrU/YgO0czWxcFCDZj8E3YN5w36xvBR/LbaV5q4Uynn3mp3LmRfQs1lTYw AXLyuEhatTBmZ4nj1aHLdKZzPnE8ArzBYBRZuqD0xeSqDsR4tPoCW17H5FJ/EmF8DrNU Ec85GS83uNf5UXqKc/ZJAAgGo4AFWRO4nw9QVG3DcWI1zMqDL1JYEHEbpz1x938TpiAd 7nFQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=x/YTEVZX7bk5PFPO8h1bcm3j6LUAomnLb0WNrNU8+As=; b=tANPkUq4poGKlDJOZ/DsMBrq6BdGRI76dls9f1hcLVbKXNZx4gM6dz2Dedz6BHQQPZ zeGR03MMUspywW12lBvdyTYTbhzAzVd8uMuNT5f2t4xpROJvp6eapZpfG2p7xrlr9aaV wv7oRgOzvr9O3yp+HHFGCoVwB8dFoe87XTXYUkVsGZcmAxyJ7aD+gwB0ReOvJsWODgLP MrQIoh614ACtJJxLUEetj+G3+UrCDuB5exjW6Hjy/l/6CuBOXGGvxiaZuwWaBA77NXuW 5m/0Jep4pN5roj/P8maxr1kb9yWCn31TyyYNP+v9xvJG9M4hj/ss2ryw4JX+6nbwAq4S PZhQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@intel.com header.s=Intel header.b=bhgfJNBu; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=intel.com Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id ba10-20020a0564021aca00b004acbe7b3479si4574104edb.653.2023.03.03.22.13.40; Fri, 03 Mar 2023 22:14:07 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@intel.com header.s=Intel header.b=bhgfJNBu; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=intel.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229676AbjCDETx (ORCPT + 99 others); Fri, 3 Mar 2023 23:19:53 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:52306 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229662AbjCDETr (ORCPT ); Fri, 3 Mar 2023 23:19:47 -0500 Received: from mga17.intel.com (mga17.intel.com [192.55.52.151]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id BE50D126EA for ; Fri, 3 Mar 2023 20:19:45 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1677903585; x=1709439585; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=IcgtldqkfkE6eHD67FeLCamBoKCMzTV2qNFng33ppWw=; b=bhgfJNBuZNt8h0hX5EEB9fRvMmF8zlAMFHVZ3YmP7ib4gdq2h4EyD1fY 6QwbcG3D0lAy9M47X41xjZhsrzO4Rp0ROudSMFQfIMcgUXu/JWocqffOg 9weHm+PslQMagB97GeTC2IzT+y9GQVbuDvl6E+DtN9qxgtZ7YOkWx1daW Nhg/Anu0075Oi//tGrQdiI/u5O2TMGRE0uJLFWnTLR9KHUbhq6V37BPJG MRiOEV54rhCYxy0gDOf1R1ntq0Zng0qaZ9jNgV3RPZtT29XmjR7DLOuJv Kl8pPHLXhoY8EwgHygvzqLloMoi0oinUKKf3ZdG1VIzTYeRA6HtbUHeJu A==; X-IronPort-AV: E=McAfee;i="6500,9779,10638"; a="315618100" X-IronPort-AV: E=Sophos;i="5.98,232,1673942400"; d="scan'208";a="315618100" Received: from orsmga001.jf.intel.com ([10.7.209.18]) by fmsmga107.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 03 Mar 2023 20:19:45 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6500,9779,10638"; a="708062010" X-IronPort-AV: E=Sophos;i="5.98,232,1673942400"; d="scan'208";a="708062010" Received: from tdx-lm.sh.intel.com ([10.239.53.27]) by orsmga001.jf.intel.com with ESMTP; 03 Mar 2023 20:19:42 -0800 From: Wei Wang To: arnd@arndb.de, akpm@linux-foundation.org, keescook@chromium.org, herbert@gondor.apana.org.au, josh@joshtriplett.org, jani.nikula@intel.com, corbet@lwn.net, jgg@mellanox.com, dmatlack@google.com, mizhang@google.com, pbonzini@redhat.com, seanjc@google.com Cc: linux-kernel@vger.kernel.org, Wei Wang Subject: [PATCH v1 2/3] Documentation/CodingStyle: do not use data type names as variable names Date: Sat, 4 Mar 2023 12:19:31 +0800 Message-Id: <20230304041932.847133-3-wei.w.wang@intel.com> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20230304041932.847133-1-wei.w.wang@intel.com> References: <20230304041932.847133-1-wei.w.wang@intel.com> MIME-Version: 1.0 X-Spam-Status: No, score=-4.4 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_MED, SPF_HELO_NONE,SPF_NONE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1759416625541540953?= X-GMAIL-MSGID: =?utf-8?q?1759416625541540953?= Observed some merged code uses "bool" as variable name. This is confusion either for the reader or compilier. Add a rule to have programmers avoid using data types as variable names. Signed-off-by: Wei Wang --- Documentation/process/coding-style.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/Documentation/process/coding-style.rst b/Documentation/process/coding-style.rst index 007e49ef6cec..6d7f4069d55d 100644 --- a/Documentation/process/coding-style.rst +++ b/Documentation/process/coding-style.rst @@ -356,6 +356,9 @@ specification that mandates those terms. For new specifications translate specification usage of the terminology to the kernel coding standard where possible. +"bool", "int", "long" etc. are specific names for data types, C +programmers should not use them as variable names. + 5) Typedefs -----------