From patchwork Fri Mar 1 13:46:35 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lukas Bulwahn X-Patchwork-Id: 208860 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7301:2097:b0:108:e6aa:91d0 with SMTP id gs23csp1086571dyb; Fri, 1 Mar 2024 05:47:26 -0800 (PST) X-Forwarded-Encrypted: i=3; AJvYcCUZ6HulNzh7GuU1M57uZXjEKqI3s3D9qzhFjaOfAVohJJoFRaR0+X0/CR0tChNm7S5fQc1rtnYou64rzPWXQBudFtRGhA== X-Google-Smtp-Source: AGHT+IEfVjJbxEuYL823kRf6t4ytCyvVEfK/NthU7Y++U2V1ss8JgStGTqtlPqBX4n9uBw2TQrw0 X-Received: by 2002:a05:6402:5c3:b0:565:7edf:41b0 with SMTP id n3-20020a05640205c300b005657edf41b0mr1356954edx.6.1709300846731; Fri, 01 Mar 2024 05:47:26 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1709300846; cv=pass; d=google.com; s=arc-20160816; b=qA3Kb0kxcHg9cSoAAEwKd4wCjCjZk8vCK8jloyC/wNtQD7OtRI2iFSff4gpaueJ9na vGf8m/wYKKXnUxPBCp2BgFhwCR241GjCmcDEHDtABL/pfie04uyUduf0H+bKOI84v7Pq LDdIacC4myVzXUs17osk0Wd/tcRhCd/GToTneSswQKX3p8MZSNebs+mGHbjE+S19wG6L RsYf3n+rzOnITKcPrxm+7ElqwHV7VI2cisCCFSzx88UO/mkuATO4v5sClzoVOu7hNMdv EZC6Yx5zK4CYdY40zgEMg8JXfGfhGs8SgO+HevkVDh9XCB+EhjFFPONYI1ruAkmAexNz zAOg== ARC-Message-Signature: i=2; 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=umwFC7DE96xZZ1X/nt8K0ZM1RN381g70mq+QxdOjW8Y=; fh=/nmZxP5I/ATr7jmLPEkatU9Fy68kskMurTKTDpK7mX4=; b=hGKZYaPdHRNVBybtHofDKMioNzm2t3TgR+gHHCX2yJPJy2UeHYhqLhKQQzWcn/zn9G b5FDgAPoAY+VmgQM1tRWVty75neqKMci8Mjn1L409ZwJtIn52SDE1BwHtGMthyTR/ad2 /5ouiKWlwinizWQraaj18n3nf7dhXQ1UqB8SgB7cwqiC567ETPHnoYQjPpRAQvqAtaVK XHEol6lkcbEePtJAQwcXdoTjAcMIwNSrGSnw1TfLoP1lgx2NVdTwnl03QrAhUtNZzlX5 9S7M56EnflywI3QwzIRSmKuNZduKGFPpZNoLT8zLLEP3id7tEhaN7sJ4DBnHLzXQH6KP V7nw==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@gmail.com header.s=20230601 header.b=ecGGc9Ds; arc=pass (i=1 spf=pass spfdomain=gmail.com dkim=pass dkdomain=gmail.com dmarc=pass fromdomain=gmail.com); spf=pass (google.com: domain of linux-kernel+bounces-88512-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) smtp.mailfrom="linux-kernel+bounces-88512-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: from am.mirrors.kernel.org (am.mirrors.kernel.org. [2604:1380:4601:e00::3]) by mx.google.com with ESMTPS id n20-20020aa7c694000000b00564409f2e72si1479170edq.673.2024.03.01.05.47.26 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 01 Mar 2024 05:47:26 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-88512-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) client-ip=2604:1380:4601:e00::3; Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20230601 header.b=ecGGc9Ds; arc=pass (i=1 spf=pass spfdomain=gmail.com dkim=pass dkdomain=gmail.com dmarc=pass fromdomain=gmail.com); spf=pass (google.com: domain of linux-kernel+bounces-88512-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) smtp.mailfrom="linux-kernel+bounces-88512-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com 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 am.mirrors.kernel.org (Postfix) with ESMTPS id 54BF81F24A74 for ; Fri, 1 Mar 2024 13:47:26 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id B68EA6F08A; Fri, 1 Mar 2024 13:46:55 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="ecGGc9Ds" Received: from mail-ed1-f49.google.com (mail-ed1-f49.google.com [209.85.208.49]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 6920A6EB5D; Fri, 1 Mar 2024 13:46:51 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.208.49 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1709300813; cv=none; b=VtwOpzuqbeIf5Sf2XDPLH9cLspnvJ4yLNZFrTFUFas/+Z6BwqcisqcRdVgalXNq82z1P2zF/GBIrgW1Fse7qOYp231/5JGIKGbtpPC/kIyDs4H9x+Zvxjnm10A5lloliDpeZqGHBheAWHM62MNlC5svq4NY0AYN0wv5I7EFpQCY= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1709300813; c=relaxed/simple; bh=5+tsegm35mr2mrlHcxRD4tBazE0gM93OVZb3DJC9fZ0=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=kURZ2uWRyZrGxRchR1LU1gtcZNkn2eoZmNGtTZEI2HMho2e0K5+RYC/wRP1c9XgF1kSOnB7KoAAMIrK2TftjGi9HuFAQu5OutNBY2vSfGcn+oWMtMsKET3k6z5k3DWBBeG/nnM0qpSROFzyf5XljxhgONFhtD/qqbKo6xG3E+qo= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=ecGGc9Ds; arc=none smtp.client-ip=209.85.208.49 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Received: by mail-ed1-f49.google.com with SMTP id 4fb4d7f45d1cf-563b7b3e3ecso3485153a12.0; Fri, 01 Mar 2024 05:46:51 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1709300810; x=1709905610; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=umwFC7DE96xZZ1X/nt8K0ZM1RN381g70mq+QxdOjW8Y=; b=ecGGc9DsJs/WI8cUoYzJ3KzCYmHJ1xsmMkpj6A4byyozqFvgxXMoLJsEwibPFfjcWI Ij8B6zX3cll5MziBVjXXRKqqdmhq9u/QBztALWrgMn18wxtx2VSMHs86VLovJBh2/KdX TEqbQZbPykGc7uQnrUB0tvDOyTFj0nyhGIAg+86QQOuS9KqUGtrTabgFbqtWuwSlfaK2 kdy5CFIldNCWGhFJRdOQeDL2URGflK16RJPjV0cyUAFwxlcEKRe0Dk9Sl7UWdRSor0VA 6seSfYc00H2zDjJGVOscnTtiBh5Tg8CrA07GlDI80NNekoq9UR/oaxgFs+Tba0JfU2h+ si6A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1709300810; x=1709905610; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=umwFC7DE96xZZ1X/nt8K0ZM1RN381g70mq+QxdOjW8Y=; b=hc7NB+khKWXY1daJpvAJdaPivD/Wxp6P90dRGtqRksFFNZhb7SC+GonIftcYnHPI+N 9rc7TN+53xLwyHusvtMA4PXRYjunHi5YujNokTiGyabgUu9vHMxBw+2k1WsUzMpLik7a t6dlGRgCR+3+0gTZvIi2W+A8SQ1wI5K1VbwN+MpHJPtGXiYAmgD97Bc66pwn8O3H1+E+ ZNZcqEHq8pw4rwX8QdfeQyUg2M+b7dxm0dSFav9MocF3ZuNfi/aRlWCuTCQuOEjPfid9 IHlXhfVMC7zUfzm/zSrxtO+UdPvTdshfP6Db89E4lDsCQw8hd8Jp+C2WGmrdF43rSVEv wbIA== X-Forwarded-Encrypted: i=1; AJvYcCX9m4ja6A5Ader+41EkFch1LDjERE7oKcszss4WesENPYvTrle8bvJLhIC4RRN5ZgUL6o0H7g3cRRWlZeLnxzD1zvscGiFeAzNj+ZM1aorJ4fih9TJGkUu6NK7l1um7lht0tcPBe77yPIR7y+lgQO5Q+q9pswlRx1HpUc1tkvQKQgv5 X-Gm-Message-State: AOJu0YzSnhkmCuNsgd7zL409wwfN1gXVJnEfEr5hMLQn5pugiz4N06fz qWnud1ZqJBMY8hId/r0wAjW7q8+U7Gy6gccivZ8N49rn/cXThYDzjQ0bh3jE4uU= X-Received: by 2002:a50:c943:0:b0:566:14e3:2262 with SMTP id p3-20020a50c943000000b0056614e32262mr1271351edh.36.1709300809753; Fri, 01 Mar 2024 05:46:49 -0800 (PST) Received: from lola.. ([2a02:810d:7e40:14b0:d371:e319:5dd0:9b35]) by smtp.gmail.com with ESMTPSA id fj10-20020a0564022b8a00b00563f8233ba8sm1584107edb.7.2024.03.01.05.46.49 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 01 Mar 2024 05:46:49 -0800 (PST) From: Lukas Bulwahn To: Jonathan Corbet , workflows@vger.kernel.org, linux-doc@vger.kernel.org Cc: kernel-janitors@vger.kernel.org, linux-kernel@vger.kernel.org, Lukas Bulwahn Subject: [PATCH 1/3] docs: submitting-patches: divert focus from PATCH in the subject line Date: Fri, 1 Mar 2024 14:46:35 +0100 Message-ID: <20240301134637.27880-2-lukas.bulwahn@gmail.com> X-Mailer: git-send-email 2.43.2 In-Reply-To: <20240301134637.27880-1-lukas.bulwahn@gmail.com> References: <20240301134637.27880-1-lukas.bulwahn@gmail.com> 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: 1792331844559630070 X-GMAIL-MSGID: 1792331844559630070 Submitting-patches is already assuming that git is used to prepare patches. So, developers will use git format-patch and git send-email, and this will take care that PATCH is usually in the subject line. Hence, the 'include PATCH in the subject' does not deserve be an own section. Move this note into 'the canonical patch format' section, where it currently fits best. Signed-off-by: Lukas Bulwahn --- Documentation/process/submitting-patches.rst | 14 ++++---------- 1 file changed, 4 insertions(+), 10 deletions(-) diff --git a/Documentation/process/submitting-patches.rst b/Documentation/process/submitting-patches.rst index 66029999b587..2ec0c0d7d68f 100644 --- a/Documentation/process/submitting-patches.rst +++ b/Documentation/process/submitting-patches.rst @@ -384,16 +384,6 @@ patch or patch series which have not been modified in any way from the previous submission. -Include PATCH in the subject ------------------------------ - -Due to high e-mail traffic to Linus, and to linux-kernel, it is common -convention to prefix your subject line with [PATCH]. This lets Linus -and other kernel developers more easily distinguish patches from other -e-mail discussions. - -``git send-email`` will do this for you automatically. - Sign your work - the Developer's Certificate of Origin ------------------------------------------------------ @@ -616,6 +606,10 @@ The canonical patch subject line is:: Subject: [PATCH 001/123] subsystem: summary phrase +Prefix your subject line with [PATCH]. This allows to distinguish patches +from other e-mail discussions. ``git send-email`` will do this for you +automatically. + The canonical patch message body contains the following: - A ``from`` line specifying the patch author, followed by an empty