Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/1.0/patches/2197658/?format=api
{ "id": 2197658, "url": "http://patchwork.ozlabs.org/api/1.0/patches/2197658/?format=api", "project": { "id": 46, "url": "http://patchwork.ozlabs.org/api/1.0/projects/46/?format=api", "name": "Intel Wired Ethernet development", "link_name": "intel-wired-lan", "list_id": "intel-wired-lan.osuosl.org", "list_email": "intel-wired-lan@osuosl.org", "web_url": "", "scm_url": "", "webscm_url": "" }, "msgid": "<744ba47877b67b369e5c255438b7fdfe7b7efa25.1771408406.git.mchehab+huawei@kernel.org>", "date": "2026-02-18T10:12:42", "name": "[12/38] docs: kdoc_parser: ignore context analysis and lock attributes", "commit_ref": null, "pull_url": null, "state": "handled-elsewhere", "archived": false, "hash": "18e2111f0c7f33d29af3ffa028f744e70a93d786", "submitter": { "id": 78235, "url": "http://patchwork.ozlabs.org/api/1.0/people/78235/?format=api", "name": "Mauro Carvalho Chehab", "email": "mchehab+huawei@kernel.org" }, "delegate": null, "mbox": "http://patchwork.ozlabs.org/project/intel-wired-lan/patch/744ba47877b67b369e5c255438b7fdfe7b7efa25.1771408406.git.mchehab+huawei@kernel.org/mbox/", "series": [ { "id": 492532, "url": "http://patchwork.ozlabs.org/api/1.0/series/492532/?format=api", "date": "2026-02-18T10:12:30", "name": "docs: several improvements to kernel-doc", "version": 1, "mbox": "http://patchwork.ozlabs.org/series/492532/mbox/" } ], "check": "pending", "checks": "http://patchwork.ozlabs.org/api/patches/2197658/checks/", "tags": {}, "headers": { "Return-Path": "<intel-wired-lan-bounces@osuosl.org>", "X-Original-To": [ "incoming@patchwork.ozlabs.org", "intel-wired-lan@lists.osuosl.org" ], "Delivered-To": [ "patchwork-incoming@legolas.ozlabs.org", "intel-wired-lan@lists.osuosl.org" ], "Authentication-Results": [ "legolas.ozlabs.org;\n\tdkim=pass (2048-bit key;\n unprotected) header.d=osuosl.org header.i=@osuosl.org header.a=rsa-sha256\n header.s=default header.b=x+y4CKGF;\n\tdkim-atps=neutral", "legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=osuosl.org\n (client-ip=2605:bc80:3010::136; helo=smtp3.osuosl.org;\n envelope-from=intel-wired-lan-bounces@osuosl.org;\n receiver=patchwork.ozlabs.org)" ], "Received": [ "from smtp3.osuosl.org (smtp3.osuosl.org [IPv6:2605:bc80:3010::136])\n\t(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n\t key-exchange x25519 server-signature ECDSA (secp384r1) server-digest SHA384)\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4fGC5T305Kz1xyD\n\tfor <incoming@patchwork.ozlabs.org>; Wed, 18 Feb 2026 21:13:33 +1100 (AEDT)", "from localhost (localhost [127.0.0.1])\n\tby smtp3.osuosl.org (Postfix) with ESMTP id 47C8B607E0;\n\tWed, 18 Feb 2026 10:13:31 +0000 (UTC)", "from smtp3.osuosl.org ([127.0.0.1])\n by localhost (smtp3.osuosl.org [127.0.0.1]) (amavis, port 10024) with ESMTP\n id eKGWrjjr9BEl; Wed, 18 Feb 2026 10:13:30 +0000 (UTC)", "from lists1.osuosl.org (lists1.osuosl.org [140.211.166.142])\n\tby smtp3.osuosl.org (Postfix) with ESMTP id 8D4E8607C0;\n\tWed, 18 Feb 2026 10:13:30 +0000 (UTC)", "from smtp4.osuosl.org (smtp4.osuosl.org [IPv6:2605:bc80:3010::137])\n by lists1.osuosl.org (Postfix) with ESMTP id 249F335B\n for <intel-wired-lan@lists.osuosl.org>; Wed, 18 Feb 2026 10:13:25 +0000 (UTC)", "from localhost (localhost [127.0.0.1])\n by smtp4.osuosl.org (Postfix) with ESMTP id BCFAB407CA\n for <intel-wired-lan@lists.osuosl.org>; Wed, 18 Feb 2026 10:13:24 +0000 (UTC)", "from smtp4.osuosl.org ([127.0.0.1])\n by localhost (smtp4.osuosl.org [127.0.0.1]) (amavis, port 10024) with ESMTP\n id AC8TPzQkxxOH for <intel-wired-lan@lists.osuosl.org>;\n Wed, 18 Feb 2026 10:13:24 +0000 (UTC)", "from tor.source.kernel.org (tor.source.kernel.org [172.105.4.254])\n by smtp4.osuosl.org (Postfix) with ESMTPS id B4C14407B7\n for <intel-wired-lan@lists.osuosl.org>; Wed, 18 Feb 2026 10:13:23 +0000 (UTC)", "from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58])\n by tor.source.kernel.org (Postfix) with ESMTP id A9F9C600AE;\n Wed, 18 Feb 2026 10:13:22 +0000 (UTC)", "by smtp.kernel.org (Postfix) with ESMTPSA id 5ABA6C2BC9E;\n Wed, 18 Feb 2026 10:13:22 +0000 (UTC)", "from mchehab by mail.kernel.org with local (Exim 4.99.1)\n (envelope-from <mchehab+huawei@kernel.org>)\n id 1vseYa-00000000LYT-2WjK; Wed, 18 Feb 2026 11:13:20 +0100" ], "X-Virus-Scanned": [ "amavis at osuosl.org", "amavis at osuosl.org" ], "X-Comment": "SPF check N/A for local connections - client-ip=140.211.166.142;\n helo=lists1.osuosl.org; envelope-from=intel-wired-lan-bounces@osuosl.org;\n receiver=<UNKNOWN> ", "DKIM-Filter": [ "OpenDKIM Filter v2.11.0 smtp3.osuosl.org 8D4E8607C0", "OpenDKIM Filter v2.11.0 smtp4.osuosl.org B4C14407B7" ], "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=osuosl.org;\n\ts=default; t=1771409610;\n\tbh=hYGGbwCkrF7438PApxlyji6v0N9OksmmbY8abxWqAME=;\n\th=From:To:Cc:Date:In-Reply-To:References:Subject:List-Id:\n\t List-Unsubscribe:List-Archive:List-Post:List-Help:List-Subscribe:\n\t From;\n\tb=x+y4CKGFaRX3uOqw6YTX6z/WOlOOBRfvJeMY/9uswFk2bXT9KKGLmup0CEdfERLr1\n\t UhIM5yko66Nn4C42GOZ6PjMpOwEvxT+UTfFpm9rc0k1Xd8VPQPu16t13fPEKyvMutx\n\t CKRAh6VOruRs9tE9RKKRjykgPd7n6+r3f4fohX7n60RVzOsjaAZw60yo2Ncmsfy59F\n\t AMPQ5Qe8qT33mxBVpY8glcw5C557q9WLRxJQBQYGJ9iWkkD7qaREnUwLFeGO542Yce\n\t vprnD7qAW6cfMZmtsfxtSbMTGQiN6sI0o/G55mHRHpHaU4ceKrBey1PyJ5jH4kqCLb\n\t /1jgY9OCXVuIA==", "Received-SPF": "Pass (mailfrom) identity=mailfrom; client-ip=172.105.4.254;\n helo=tor.source.kernel.org; envelope-from=mchehab+huawei@kernel.org;\n receiver=<UNKNOWN>", "DMARC-Filter": "OpenDMARC Filter v1.4.2 smtp4.osuosl.org B4C14407B7", "From": "Mauro Carvalho Chehab <mchehab+huawei@kernel.org>", "To": "Jonathan Corbet <corbet@lwn.net>,\n Linux Doc Mailing List <linux-doc@vger.kernel.org>", "Cc": "Mauro Carvalho Chehab <mchehab+huawei@kernel.org>,\n intel-wired-lan@lists.osuosl.org, linux-hardening@vger.kernel.org,\n linux-kernel@vger.kernel.org, netdev@vger.kernel.org,\n Aleksandr Loktionov <aleksandr.loktionov@intel.com>,\n Randy Dunlap <rdunlap@infradead.org>,\n Stephen Rothwell <sfr@canb.auug.org.au>", "Date": "Wed, 18 Feb 2026 11:12:42 +0100", "Message-ID": "\n <744ba47877b67b369e5c255438b7fdfe7b7efa25.1771408406.git.mchehab+huawei@kernel.org>", "X-Mailer": "git-send-email 2.52.0", "In-Reply-To": "<cover.1771408406.git.mchehab+huawei@kernel.org>", "References": "<cover.1771408406.git.mchehab+huawei@kernel.org>", "MIME-Version": "1.0", "Content-Type": "text/plain; charset=\"utf-8\"", "Content-Transfer-Encoding": "8bit", "X-Mailman-Original-DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/simple;\n d=kernel.org; s=k20201202; t=1771409602;\n bh=o+XwvOhwzAMJSmWQIfpQC03ux6SeS1yBhcVlaWB7ox4=;\n h=From:To:Cc:Subject:Date:In-Reply-To:References:From;\n b=dxqsx67iD7IO8HPXRN3Njq0M9bTXSSPVhccyyOt+BvU+8mhOHNWJKTeRPQ3WU1wGP\n JEvWkInGLhAmbtvLtqlXpjQ8I3rUcYOnge7rcxAhhtqkrhkfdC0+peEYKiDixyes7G\n hmIcvO4cMhco9MCd1NM9ZCJ9gSTIwMn4Qk08HtihWVJK/L89NjhEQ/njBqIBIT2qlK\n /mGCNZDZ0Bqezgz3ezMCmJtMNojGBY8+4nSyJIlxeYdaeQRLx0nUm3YSKZjsgpFELS\n wvRq2xgVSAXmi/5Udqo5zEMciRQUzcqfIQmZ9r9xNQZY7cexbBcpoB07AGgpdpLMv1\n djy3SvemE6+rg==", "X-Mailman-Original-Authentication-Results": [ "smtp4.osuosl.org;\n dmarc=pass (p=quarantine dis=none)\n header.from=kernel.org", "smtp4.osuosl.org;\n dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org\n header.a=rsa-sha256 header.s=k20201202 header.b=dxqsx67i" ], "Subject": "[Intel-wired-lan] [PATCH 12/38] docs: kdoc_parser: ignore context\n analysis and lock attributes", "X-BeenThere": "intel-wired-lan@osuosl.org", "X-Mailman-Version": "2.1.30", "Precedence": "list", "List-Id": "Intel Wired Ethernet Linux Kernel Driver Development\n <intel-wired-lan.osuosl.org>", "List-Unsubscribe": "<https://lists.osuosl.org/mailman/options/intel-wired-lan>,\n <mailto:intel-wired-lan-request@osuosl.org?subject=unsubscribe>", "List-Archive": "<http://lists.osuosl.org/pipermail/intel-wired-lan/>", "List-Post": "<mailto:intel-wired-lan@osuosl.org>", "List-Help": "<mailto:intel-wired-lan-request@osuosl.org?subject=help>", "List-Subscribe": "<https://lists.osuosl.org/mailman/listinfo/intel-wired-lan>,\n <mailto:intel-wired-lan-request@osuosl.org?subject=subscribe>", "Errors-To": "intel-wired-lan-bounces@osuosl.org", "Sender": "\"Intel-wired-lan\" <intel-wired-lan-bounces@osuosl.org>" }, "content": "From: Randy Dunlap <rdunlap@infradead.org>\n\nDrop all context analysis and lock (tracking) attributes to avoid\nkernel-doc warnings.\n\nDocumentation/core-api/kref:328: ../include/linux/kref.h:72: WARNING: Invalid C declaration: Expected end of definition. [error at 96]\n int kref_put_mutex (struct kref *kref, void (*release)(struct kref *kref), struct mutex *mutex) __cond_acquires(true# mutex)\n ------------------------------------------------------------------------------------------------^\nDocumentation/core-api/kref:328: ../include/linux/kref.h:94: WARNING: Invalid C declaration: Expected end of definition. [error at 92]\n int kref_put_lock (struct kref *kref, void (*release)(struct kref *kref), spinlock_t *lock) __cond_acquires(true# lock)\n --------------------------------------------------------------------------------------------^\n\nThe regex is suggested by Mauro; mine was too greedy. Thanks.\nUpdated context analysis and lock macros list provided by PeterZ. Thanks.\n\nReported-by: Stephen Rothwell <sfr@canb.auug.org.au>\nCloses: https://lore.kernel.org/all/20260107161548.45530e1c@canb.auug.org.au/\nSigned-off-by: Randy Dunlap <rdunlap@infradead.org>\nReviewed-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>\nReviewed-by: Aleksandr Loktionov <aleksandr.loktionov@intel.com>\nSigned-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>\n---\n tools/lib/python/kdoc/kdoc_parser.py | 15 +++++++++++++++\n 1 file changed, 15 insertions(+)", "diff": "diff --git a/tools/lib/python/kdoc/kdoc_parser.py b/tools/lib/python/kdoc/kdoc_parser.py\nindex f524385543a6..25d8a89f32b2 100644\n--- a/tools/lib/python/kdoc/kdoc_parser.py\n+++ b/tools/lib/python/kdoc/kdoc_parser.py\n@@ -81,6 +81,8 @@ struct_xforms = [\n (KernRe(r'\\s*__aligned\\s*\\([^;]*\\)', re.S), ' '),\n (KernRe(r'\\s*__counted_by\\s*\\([^;]*\\)', re.S), ' '),\n (KernRe(r'\\s*__counted_by_(le|be)\\s*\\([^;]*\\)', re.S), ' '),\n+ (KernRe(r'\\s*__guarded_by\\s*\\([^\\)]*\\)', re.S), ' '),\n+ (KernRe(r'\\s*__pt_guarded_by\\s*\\([^\\)]*\\)', re.S), ' '),\n (KernRe(r'\\s*__packed\\s*', re.S), ' '),\n (KernRe(r'\\s*CRYPTO_MINALIGN_ATTR', re.S), ' '),\n (KernRe(r'\\s*__private', re.S), ' '),\n@@ -165,6 +167,16 @@ struct_nested_prefixes = [\n # the start delimiter.\n #\n function_nested_prefixes = [\n+ (re.compile(r\"__cond_acquires\\s*\\(\"), \"\"),\n+ (re.compile(r\"__cond_releases\\s*\\(\"), \"\"),\n+ (re.compile(r\"__acquires\\s*\\(\"), \"\"),\n+ (re.compile(r\"__releases\\s*\\(\"), \"\"),\n+ (re.compile(r\"__must_hold\\s*\\(\"), \"\"),\n+ (re.compile(r\"__must_not_hold\\s*\\(\"), \"\"),\n+ (re.compile(r\"__must_hold_shared\\s*\\(\"), \"\"),\n+ (re.compile(r\"__cond_acquires_shared\\s*\\(\"), \"\"),\n+ (re.compile(r\"__acquires_shared\\s*\\(\"), \"\"),\n+ (re.compile(r\"__releases_shared\\s*\\(\"), \"\"),\n (re.compile(r\"__attribute__\\s*\\(\"), \"\"),\n ]\n \n@@ -196,6 +208,7 @@ function_xforms = [\n (KernRe(r\"__(?:re)?alloc_size\\s*\\(\\s*\\d+\\s*(?:,\\s*\\d+\\s*)?\\) +\"), \"\"),\n (KernRe(r\"__diagnose_as\\s*\\(\\s*\\S+\\s*(?:,\\s*\\d+\\s*)*\\) +\"), \"\"),\n (KernRe(r\"DECL_BUCKET_PARAMS\\s*\\(\\s*(\\S+)\\s*,\\s*(\\S+)\\s*\\)\"), r\"\\1, \\2\"),\n+ (KernRe(r\"__no_context_analysis\\s*\"), \"\"),\n (KernRe(r\"__attribute_const__ +\"), \"\"),\n ]\n \n@@ -205,6 +218,8 @@ function_xforms = [\n var_xforms = [\n (KernRe(r\"__read_mostly\"), \"\"),\n (KernRe(r\"__ro_after_init\"), \"\"),\n+ (KernRe(r'\\s*__guarded_by\\s*\\([^\\)]*\\)', re.S), \"\"),\n+ (KernRe(r'\\s*__pt_guarded_by\\s*\\([^\\)]*\\)', re.S), \"\"),\n (KernRe(r\"(?://.*)$\"), \"\"),\n (KernRe(r\"(?:/\\*.*\\*/)\"), \"\"),\n (KernRe(r\";$\"), \"\"),\n", "prefixes": [ "12/38" ] }