From nobody Thu Oct 2 10:53:50 2025 Received: from forward102a.mail.yandex.net (forward102a.mail.yandex.net [178.154.239.85]) (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 7006F2FF154; Wed, 17 Sep 2025 17:37:49 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=178.154.239.85 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1758130672; cv=none; b=G37rjTFiTFFCoZWukyiCzApUbOsjuq96z02sGuYbzm+xIgir0evQvz9eR8FvOqemBE4CVYLIkgI6L4Iztcjp2ADYrIKoenZDrJnis6Sdlan2Bfs2gd8Fh4XWTsKzgfVxYCMqh3yCQ679cZRfsysAFCubm2Fjg7MLMkm0WqvImXg= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1758130672; c=relaxed/simple; bh=tfk4fqPBXMxRIaTR8JVHfpkSvMMR2GkGexE4r9khsXw=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=JQ20S7iRSASY0dEqpHn3XKtUwlds/dJ1e5Q1nehGUkC+5aeBe28siHkAG51MlZefO41Twd/dN9Cd1f+Rv8xu2eHpDvAAoQTU1ISbfl52qamlcgu1sfYmTR6x/C8ejb2oG0OUuu17Y//4RUaS9mFmhF+ZvKF4dx0z9dVFObsBYFk= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=onurozkan.dev; spf=pass smtp.mailfrom=onurozkan.dev; dkim=pass (1024-bit key) header.d=onurozkan.dev header.i=@onurozkan.dev header.b=AGUQp+yT; arc=none smtp.client-ip=178.154.239.85 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=onurozkan.dev Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=onurozkan.dev Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=onurozkan.dev header.i=@onurozkan.dev header.b="AGUQp+yT" Received: from mail-nwsmtp-smtp-production-main-68.vla.yp-c.yandex.net (mail-nwsmtp-smtp-production-main-68.vla.yp-c.yandex.net [IPv6:2a02:6b8:c1d:3d8d:0:640:b127:0]) by forward102a.mail.yandex.net (Yandex) with ESMTPS id BE8D8C0066; Wed, 17 Sep 2025 20:37:40 +0300 (MSK) Received: by mail-nwsmtp-smtp-production-main-68.vla.yp-c.yandex.net (smtp/Yandex) with ESMTPSA id QbVY4BEMvqM0-PhpswjxX; Wed, 17 Sep 2025 20:37:39 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=onurozkan.dev; s=mail; t=1758130660; bh=hjZ+juQ9tvN1nhjSWM62sYVPVXM0kUendq49dvZ0/Qg=; h=Cc:Message-ID:References:Date:In-Reply-To:Subject:To:From; b=AGUQp+yTQXYDPj34IzXXOyUNDxkWGRTVJ3V57yiw2alNANnK+VLYJKSFyA1YXkqph k8/PJa1yLxafhJja+scOEMTrCDDwnTYbkpPp6ckM+e7P+FTiDKs6zdwU1hBvNaI2HI oEVk9vrYk1eXa+xePloHXE97xWaaoQ6Pqd4/Dn70= Authentication-Results: mail-nwsmtp-smtp-production-main-68.vla.yp-c.yandex.net; dkim=pass header.i=@onurozkan.dev From: =?UTF-8?q?Onur=20=C3=96zkan?= To: linux-kernel@vger.kernel.org Cc: apw@canonical.com, joe@perches.com, dwaipayanray1@gmail.com, lukas.bulwahn@gmail.com, corbet@lwn.net, workflows@vger.kernel.org, linux-doc@vger.kernel.org, =?UTF-8?q?Onur=20=C3=96zkan?= Subject: [PATCH v2 1/2] checkpatch: detect unhandled placeholders in cover letters Date: Wed, 17 Sep 2025 20:37:24 +0300 Message-ID: <20250917173725.22547-2-work@onurozkan.dev> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20250917173725.22547-1-work@onurozkan.dev> References: <20250917173725.22547-1-work@onurozkan.dev> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Adds a new check PLACEHOLDER_USE to detect unhandled placeholders. This prevents sending patch series with incomplete patches (mostly in cover letters) containing auto generated subject or blurb lines. These placeholders can be seen on mailing lists. With this change, checkpatch will emit an error when such text is found. Signed-off-by: Onur =C3=96zkan --- scripts/checkpatch.pl | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/scripts/checkpatch.pl b/scripts/checkpatch.pl index e722dd6fa8ef..965faee71935 100755 --- a/scripts/checkpatch.pl +++ b/scripts/checkpatch.pl @@ -3340,6 +3340,13 @@ sub process { } } =20 +# Check for auto-generated unhandled placeholder text (mostly for cover le= tters) + if (($in_commit_log || $in_header_lines) && + $rawline =3D~ /(?:SUBJECT|BLURB) HERE/) { + ERROR("PLACEHOLDER_USE", + "Placeholder text detected\n" . $herecurr); + } + # Check for git id commit length and improperly formed commit descriptions # A correctly formed commit description is: # commit ("Complete commit subject") --=20 2.51.0 From nobody Thu Oct 2 10:53:50 2025 Received: from forward101a.mail.yandex.net (forward101a.mail.yandex.net [178.154.239.84]) (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 98DB92FCC02; Wed, 17 Sep 2025 17:37:45 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=178.154.239.84 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1758130668; cv=none; b=NivbVMr6I564bKg3UNQzL8olhMEXGDTnAZBkN4Ja+j0ns0HfhCevBrPevaa7n5AJjyFofULjiCUKkAnWoVyKaBnqh/PS8bNyAcnby2WiGFRdFtnZ9Z5lTyV0/xPaYSzYpZ2mWGV2dcuD5gW44s889W0H52TfSapDeIpE/3TUeVQ= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1758130668; c=relaxed/simple; bh=FeHc2ONr7s04G4Tg/b/11N/b224Jf+60qRqcE40KnqA=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=afjvhpAsBjeqSQ9HaKzYRA6Cc/xtIhdEYsLyY+buyKAeKZlyS0QbPAHqvtnTV1HUHmX6Z+ziONP+XGuoPZvTPPPbYQ6cKPgoXo63+UkEpkwL/3Pjk5rd+zD1rlz3tHGNdjcudDvfgWF85EqmW0A77iUelPWwVb8fKRx6+k52e4E= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=onurozkan.dev; spf=pass smtp.mailfrom=onurozkan.dev; dkim=pass (1024-bit key) header.d=onurozkan.dev header.i=@onurozkan.dev header.b=SelNXlLX; arc=none smtp.client-ip=178.154.239.84 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=onurozkan.dev Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=onurozkan.dev Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=onurozkan.dev header.i=@onurozkan.dev header.b="SelNXlLX" Received: from mail-nwsmtp-smtp-production-main-68.vla.yp-c.yandex.net (mail-nwsmtp-smtp-production-main-68.vla.yp-c.yandex.net [IPv6:2a02:6b8:c1d:3d8d:0:640:b127:0]) by forward101a.mail.yandex.net (Yandex) with ESMTPS id 9D33C804BE; Wed, 17 Sep 2025 20:37:42 +0300 (MSK) Received: by mail-nwsmtp-smtp-production-main-68.vla.yp-c.yandex.net (smtp/Yandex) with ESMTPSA id QbVY4BEMvqM0-mtIkOX9L; Wed, 17 Sep 2025 20:37:41 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=onurozkan.dev; s=mail; t=1758130662; bh=FHA5v4PLTpxfi6OmrXgAH87gu7nGTp+EMy8vrMv+SVA=; h=Cc:Message-ID:References:Date:In-Reply-To:Subject:To:From; b=SelNXlLXJNz9b+6uAZEwM/oAtoQmGYYKpI0/IQgMgIHlB9l7yzyLcMoO5eHj7sJwc 27yywaPXA2L58QhdMC7O79bR0filHEo+WsfsJg2QFJxTj/FRQrUYRZy+QN6CSB2TZR 6ltc6A9rjIgEhg8AhQq3eoVx5NefY4buASypd6Zc= Authentication-Results: mail-nwsmtp-smtp-production-main-68.vla.yp-c.yandex.net; dkim=pass header.i=@onurozkan.dev From: =?UTF-8?q?Onur=20=C3=96zkan?= To: linux-kernel@vger.kernel.org Cc: apw@canonical.com, joe@perches.com, dwaipayanray1@gmail.com, lukas.bulwahn@gmail.com, corbet@lwn.net, workflows@vger.kernel.org, linux-doc@vger.kernel.org, =?UTF-8?q?Onur=20=C3=96zkan?= Subject: [PATCH v2 2/2] checkpatch: document new check PLACEHOLDER_USE Date: Wed, 17 Sep 2025 20:37:25 +0300 Message-ID: <20250917173725.22547-3-work@onurozkan.dev> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20250917173725.22547-1-work@onurozkan.dev> References: <20250917173725.22547-1-work@onurozkan.dev> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Adds documentation for the new check PLACEHOLDER_USE in checkpatch. Signed-off-by: Onur =C3=96zkan --- Documentation/dev-tools/checkpatch.rst | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/Documentation/dev-tools/checkpatch.rst b/Documentation/dev-too= ls/checkpatch.rst index d5c47e560324..4dccd1036870 100644 --- a/Documentation/dev-tools/checkpatch.rst +++ b/Documentation/dev-tools/checkpatch.rst @@ -1245,6 +1245,16 @@ Others The patch file does not appear to be in unified-diff format. Please regenerate the patch file before sending it to the maintainer. =20 + **PLACEHOLDER_USE** + Detects unhandled placeholder text left in cover letters or commit hea= ders/logs. + Common placeholders include lines like:: + + *** SUBJECT HERE *** + *** BLURB HERE *** + + These typically come from autogenerated templates. Replace them with a= proper + subject and description before sending. + **PRINTF_0XDECIMAL** Prefixing 0x with decimal output is defective and should be corrected. =20 --=20 2.51.0