From patchwork Mon Jan 8 20:18:43 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Yueh-Shun Li X-Patchwork-Id: 18836 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7300:37c1:b0:101:2151:f287 with SMTP id y1csp1254838dyq; Mon, 8 Jan 2024 12:19:32 -0800 (PST) X-Google-Smtp-Source: AGHT+IHKbt42KG6iMyS19ze45wCbQMh7z72N1eCnYqr5zT6K6eRQ0WvfBdvYo/HRCEhdJZN6cLss X-Received: by 2002:a17:90a:7566:b0:28c:f87e:f812 with SMTP id q93-20020a17090a756600b0028cf87ef812mr2003330pjk.43.1704745172404; Mon, 08 Jan 2024 12:19:32 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1704745172; cv=none; d=google.com; s=arc-20160816; b=QcmdK9ENQhc33GhRGVwzz1VZc1DZxUST9X+22gAb3oMdofB/714LqaGqZNvWOO7NkH MDsCgU2ZDF0qqspkPhLlQfLzj/Rvmr7kgnUREr5zhIRUWVVYb/49h0Z3pRuwlA7urygk RtafD+UWQkewlcvCpKFfZXHv5oDL9U3jo+5YuFLf5dc2JoG7JJmsyvDCgnLv8IbPQ36b FPKRuSatB0BLXAKEpIducAy/mD2TLxjk4MVhOle0wGd0ZFLRpCf3MtqN/iHRmB4vP1Ty 8PES+ymounQS2vB2BFv3hL8IZZf67ervWYuwgtu0I4ufCw7pSGE0H2+9Fa9kJfM7IbAr KMDg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:list-unsubscribe :list-subscribe:list-id:precedence:references:in-reply-to:message-id :date:subject:cc:to:from:dkim-signature; bh=x45Xd5a3CD2NjeGFZ0TOrm1pPW6WS1qzAGE/E79hbuk=; fh=Ad9V+S7Yf0YSz06+U9OESxrocJHibxRsxD1mZGFI62o=; b=KN1R0YClNoPbgK5nnPqA/klKbLr+ye+mpjus7CEYI25TEnaeXJ7xj7xCSg7nV8nM7X qGI9oaEzpMZeXPQNYHpTZylhrPvjkbMN8wv+HjKZ/iv2JZw4agcG1XdXU7+YSQW41KO3 ztfJjmjsvmOiQwtkZi/CtPQxBoKKOp5OxTR1poU43/42uy25g1QfT5STjsIDhAdz3Tev CMC25ni3t/FecY3MFap6cJoVvumLjRU2ZRJUEGq2Xk8t1fnuhy6U5T7gWqaoVi4PCL5K JemhrI+ZLOUHVY/A0A6dW3BEteto+OXveemWQmHYKDSAH3pokRaS3kgpCSU3fmr1xehy gWEg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@posteo.net header.s=2017 header.b=Km3dH0NA; spf=pass (google.com: domain of linux-kernel+bounces-20084-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-20084-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=posteo.net Received: from sv.mirrors.kernel.org (sv.mirrors.kernel.org. [2604:1380:45e3:2400::1]) by mx.google.com with ESMTPS id qa18-20020a17090b4fd200b0028d08bac2b9si415279pjb.17.2024.01.08.12.19.32 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 08 Jan 2024 12:19:32 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-20084-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) client-ip=2604:1380:45e3:2400::1; Authentication-Results: mx.google.com; dkim=pass header.i=@posteo.net header.s=2017 header.b=Km3dH0NA; spf=pass (google.com: domain of linux-kernel+bounces-20084-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-20084-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=posteo.net Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by sv.mirrors.kernel.org (Postfix) with ESMTPS id 3291D284781 for ; Mon, 8 Jan 2024 20:19:32 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id F0A2155C00; Mon, 8 Jan 2024 20:19:19 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=posteo.net header.i=@posteo.net header.b="Km3dH0NA" X-Original-To: linux-kernel@vger.kernel.org Received: from mout02.posteo.de (mout02.posteo.de [185.67.36.66]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 1BE0F55C09 for ; Mon, 8 Jan 2024 20:19:16 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=posteo.net Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=posteo.net Received: from submission (posteo.de [185.67.36.169]) by mout02.posteo.de (Postfix) with ESMTPS id 40F28240106 for ; Mon, 8 Jan 2024 21:19:14 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017; t=1704745154; bh=lf5MzC4u4JCsFDts+R6PhzoZ89yrvoguPVHpbORk/xM=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version: Content-Transfer-Encoding:From; b=Km3dH0NAQ/+OVyp0gZoHmgkUdE4Au5dJCt40AfOdRbMX1Vdf6xfiSAzHZgZMxRKDd x54VunuwvfGuHCXkTYywpZzvGcjSr54UPS+FHMZE2MnzvtYc99UnmmH7XkjpC33BJ2 X1exeYs+ObCKws+reFDxjAqXbBfbuo02xmym2Bg/E5I9FwNpDrmCOMR5VHewFihXDB pZeFSuLpqf8T/SPKBDfVi21rDsEVB44OOz7N0Ee6tHhwMZy6KVAesLYDAjGQtHjdJI tbswdHEHNeyIsBDrJwD2UONBxhuhbOkx9RyyfGu/NYwSSn/j+gBV1GaLXGDRB3Tz7L PYoMDfNpKiCtw== Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4T854Z1lvxz9rxK; Mon, 8 Jan 2024 21:19:09 +0100 (CET) From: Yueh-Shun Li To: Jonathan Corbet , Hu Haowen , Alex Shi , Yanteng Si , Randy Dunlap Cc: Yueh-Shun Li , workflows@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH v3 0/1] coding-style: recommend reusing macros from split headers instead of kernel.h Date: Mon, 8 Jan 2024 20:18:43 +0000 Message-ID: <20240108201851.191604-1-shamrocklee@posteo.net> In-Reply-To: <107b6b5e-ca14-4b2b-ba2e-38ecd74c0ad3@infradead.org> References: <107b6b5e-ca14-4b2b-ba2e-38ecd74c0ad3@infradead.org> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1787539557713539287 X-GMAIL-MSGID: 1787554873443279101 Dear Maintainers, This patch targets the "Linux kernel coding style" documentation and recommend reusing macros inside the include/linux directory instead of the obsolete header "include/linux/kernel.h". This addresses the issue 'Irrelevant documentation recommending the use of "include/linux/kernel.h"'[1][2] and help deprecating "kernel.h". Changes in this roll: Drop the patch mentioning the naming collisions caused by locally-defined macro variants.[3] Drop the patches that updates the zh_TW and zh_CN translation. I'll send them again once the change of the untranslated documentation gets ready. Best regards, Shamrock [1]: https://lore.kernel.org/linux-doc/bc63acd7ef43bdd8d9609fa48dbf92f9@posteo.net/ [2]: https://lore.kernel.org/linux-doc/107b6b5e-ca14-4b2b-ba2e-38ecd74c0ad3@infradead.org/ [3]: https://lore.kernel.org/linux-doc/87ederwuid.fsf@meer.lwn.net/ Yueh-Shun Li (1): coding-style: recommend split headers instead of kernel.h Documentation/process/coding-style.rst | 24 +++++++++++++----------- 1 file changed, 13 insertions(+), 11 deletions(-)