From nobody Thu Dec 18 20:32:52 2025 Received: from mail-wr1-f74.google.com (mail-wr1-f74.google.com [209.85.221.74]) (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 1DFA420AF86 for ; Mon, 13 Jan 2025 16:04:42 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.221.74 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1736784284; cv=none; b=Iwzir+8WZxTeDoOXLPBSIvGSi1CwK3kNxTwyi3vKgWS1lB2v4cor7qoY53i288U2uE6hdJ9OW9vpj8i+UDiLNKWXrg0rM29oQYqSIV3gUojdBabziFqgmSq99r8ecMKfiIukKw7loA5FVtfi1bKZMdGEwu6UtEF5oW/u/8cZwe0= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1736784284; c=relaxed/simple; bh=898AJi3XrEHjuykKfEu9B2Ef2aNDlj/0p6BNqdRz0q0=; h=Date:In-Reply-To:Mime-Version:References:Message-ID:Subject:From: To:Cc:Content-Type; b=CQnwWnkChAk2tkB3ko+ZhgRzofDHHXT0rCB/YWT1fr0CTOYhwQDbVw/fTr2SMxl/yYbtLYKvrgHqRVIeJAFcTcG+1inPdiHUQzxwku2+hPexUmVsusXspzYsrvDH4HOAYmIiJhYT/wLaihY0OCKHxG80HaOWIj7OTl8de1moLzU= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=google.com; spf=pass smtp.mailfrom=flex--jackmanb.bounces.google.com; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b=jkOruu3K; arc=none smtp.client-ip=209.85.221.74 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=google.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=flex--jackmanb.bounces.google.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b="jkOruu3K" Received: by mail-wr1-f74.google.com with SMTP id ffacd0b85a97d-385e03f54d0so2035816f8f.3 for ; Mon, 13 Jan 2025 08:04:42 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20230601; t=1736784281; x=1737389081; darn=vger.kernel.org; h=cc:to:from:subject:message-id:references:mime-version:in-reply-to :date:from:to:cc:subject:date:message-id:reply-to; bh=8iJsjt13iOc51/UXedpaSuh8SQXuFRCMoVOy4eFkEaY=; b=jkOruu3KqlqT7jpsuSztzLdO/RoHSiBtGCuCAZUR0Dbm3E/eQSGkH94PE9Sd6gFYS2 0hkpMJnBpIh4CJ4qaNGue5YUaSimTohh25aTtXB4DOqKH3EwWZcsqOcTaoqZzqwcnGuI WzuQnq231j3tbpMfkhCvRxbnvrtEjglvWAVXoNGhI9qpgYSPi6kPHjERoP1v+AmGLTIM vF/P23+hdK7o1A+81PshO6o9kv9h+aH5pdVVjLjx1ztjvJrB/UqHNvh0IM9fOP2USXWm mtA5ECHqx+mFVSihLpnUFrCX5hOOSUenNWHyk6xKB5zppDkOy52MAj85GoHU4mOwGxEb B07A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1736784281; x=1737389081; h=cc:to:from:subject:message-id:references:mime-version:in-reply-to :date:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=8iJsjt13iOc51/UXedpaSuh8SQXuFRCMoVOy4eFkEaY=; b=rpH6mli11XAgPbUx4SjEozE9K3rzx8upVSw2fnjRjeDZiUq+CoeihJh14EFQQqpGpO RMlA7NV8PzfIjHKaStzFj19oLK7sBDZldnZK6Q0j3oA0UyxcGRefTc1UnLe8hwFjsFAZ fuwpPN/qaz9obH/167eJgxHWdR8nCXRtO5wM/TekSCh6LWXxTp6yQni23CcfIhGgCs1e wqoG9VwejvoGzUeQtaspFROvPpFvzFnUNf33g6mczuLiAVER75cWQZ8Dm9jrJyCKrWLe +h72M5vZnjsMPaDbopwtXV1bB5pQekI1Y+IXSQLhBsnWEtNN806kRgqvgWKCUUEVgDe4 MtFg== X-Gm-Message-State: AOJu0Yw9hDjRkyu3HG+fg9QqfrSHYNgKFGRCl6FXZHbWFGlnqPI85FTS wdg95CmCHhsBwPEskVP0xHLOCuFCSuDd/El4pwlMQTGCqCK6PMit6PVXGBn1bIzanH+3dgsqgcJ tBAoq+fVHzQ== X-Google-Smtp-Source: AGHT+IH8/v9AOfqbaB+ul74RwUnP2y2VXUgVGbH+j4c+1CzZN8TUArYCxCFU+cwMJLC/Yo+TCWKG3KPZcq5Y1A== X-Received: from wrbee8.prod.google.com ([2002:a05:6000:2108:b0:38b:d7a4:7ee]) (user=jackmanb job=prod-delivery.src-stubby-dispatcher) by 2002:a5d:6d03:0:b0:385:e3b8:f331 with SMTP id ffacd0b85a97d-38a873035c5mr19303672f8f.14.1736784281542; Mon, 13 Jan 2025 08:04:41 -0800 (PST) Date: Mon, 13 Jan 2025 16:04:23 +0000 In-Reply-To: <20250113-checkpatch-ignore-v1-0-63a7a740f568@google.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: Mime-Version: 1.0 References: <20250113-checkpatch-ignore-v1-0-63a7a740f568@google.com> X-Mailer: b4 0.15-dev Message-ID: <20250113-checkpatch-ignore-v1-2-63a7a740f568@google.com> Subject: [PATCH 2/2] docs: checkpatch: Document Checkpatch-ignore patch footer From: Brendan Jackman To: Andy Whitcroft , Joe Perches , Dwaipayan Ray , Lukas Bulwahn , Jonathan Corbet Cc: linux-kernel@vger.kernel.org, workflows@vger.kernel.org, linux-doc@vger.kernel.org, Brendan Jackman Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable If included in patch descriptions, this will function much like the --ignore flag. Checkpatch-ignore: EMAIL_SUBJECT Signed-off-by: Brendan Jackman --- Documentation/dev-tools/checkpatch.rst | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/Documentation/dev-tools/checkpatch.rst b/Documentation/dev-too= ls/checkpatch.rst index abb3ff6820766ee0c29112b256bcc44ce41fffba..b1d5616c72029d3d8c8c236cd8d= 05bb839018c0a 100644 --- a/Documentation/dev-tools/checkpatch.rst +++ b/Documentation/dev-tools/checkpatch.rst @@ -10,8 +10,12 @@ also be run on file contexts and without the kernel tree. =20 Checkpatch is not always right. Your judgement takes precedence over check= patch messages. If your code looks better with the violations, then its probably -best left alone. +best left alone. If you do that, consider adding the Checkpatch-ignore pa= tch +footer to record this decision. =20 +For example:: + + Checkpatch-ignore: EMAIL_SUBJECT,MACRO_ARG_REUSE =20 Options =3D=3D=3D=3D=3D=3D=3D @@ -114,6 +118,9 @@ Available options: =20 Checkpatch will not emit messages for the specified types. =20 + Note that violations can also be permanently disabled using the + Checkpatch-ignore patch footer. + Example:: =20 ./scripts/checkpatch.pl mypatch.patch --ignore EMAIL_SUBJECT,BRACES --=20 2.47.1.613.gc27f4b7a9f-goog