Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/1.0/patches/2197663/?format=api
{ "id": 2197663, "url": "http://patchwork.ozlabs.org/api/1.0/patches/2197663/?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": "<cee0338b152e57b841664bde9081db6f34ad5d33.1771408406.git.mchehab+huawei@kernel.org>", "date": "2026-02-18T10:12:50", "name": "[20/38] docs: kdoc_re: add support on NestedMatch for argument replacement", "commit_ref": null, "pull_url": null, "state": "handled-elsewhere", "archived": false, "hash": "aa051ca38eec25e712a78a4209aa95480099933e", "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/cee0338b152e57b841664bde9081db6f34ad5d33.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/2197663/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=6xwHbyDK;\n\tdkim-atps=neutral", "legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=osuosl.org\n (client-ip=2605:bc80:3010::138; helo=smtp1.osuosl.org;\n envelope-from=intel-wired-lan-bounces@osuosl.org;\n receiver=patchwork.ozlabs.org)" ], "Received": [ "from smtp1.osuosl.org (smtp1.osuosl.org [IPv6:2605:bc80:3010::138])\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 4fGC5Y36ySz1xpl\n\tfor <incoming@patchwork.ozlabs.org>; Wed, 18 Feb 2026 21:13:37 +1100 (AEDT)", "from localhost (localhost [127.0.0.1])\n\tby smtp1.osuosl.org (Postfix) with ESMTP id B971A81097;\n\tWed, 18 Feb 2026 10:13:33 +0000 (UTC)", "from smtp1.osuosl.org ([127.0.0.1])\n by localhost (smtp1.osuosl.org [127.0.0.1]) (amavis, port 10024) with ESMTP\n id 1MsgXm1i5Btu; Wed, 18 Feb 2026 10:13:33 +0000 (UTC)", "from lists1.osuosl.org (lists1.osuosl.org [140.211.166.142])\n\tby smtp1.osuosl.org (Postfix) with ESMTP id EAC23810B4;\n\tWed, 18 Feb 2026 10:13:32 +0000 (UTC)", "from smtp2.osuosl.org (smtp2.osuosl.org [IPv6:2605:bc80:3010::133])\n by lists1.osuosl.org (Postfix) with ESMTP id C564A35B\n for <intel-wired-lan@lists.osuosl.org>; Wed, 18 Feb 2026 10:13:26 +0000 (UTC)", "from localhost (localhost [127.0.0.1])\n by smtp2.osuosl.org (Postfix) with ESMTP id AB46140175\n for <intel-wired-lan@lists.osuosl.org>; Wed, 18 Feb 2026 10:13:26 +0000 (UTC)", "from smtp2.osuosl.org ([127.0.0.1])\n by localhost (smtp2.osuosl.org [127.0.0.1]) (amavis, port 10024) with ESMTP\n id jLqqd10kYIof for <intel-wired-lan@lists.osuosl.org>;\n Wed, 18 Feb 2026 10:13:26 +0000 (UTC)", "from sea.source.kernel.org (sea.source.kernel.org [172.234.252.31])\n by smtp2.osuosl.org (Postfix) with ESMTPS id 0F8D84009A\n for <intel-wired-lan@lists.osuosl.org>; Wed, 18 Feb 2026 10:13:25 +0000 (UTC)", "from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58])\n by sea.source.kernel.org (Postfix) with ESMTP id 932F043D94;\n Wed, 18 Feb 2026 10:13:25 +0000 (UTC)", "by smtp.kernel.org (Postfix) with ESMTPSA id 76FEDC19421;\n Wed, 18 Feb 2026 10:13:25 +0000 (UTC)", "from mchehab by mail.kernel.org with local (Exim 4.99.1)\n (envelope-from <mchehab+huawei@kernel.org>)\n id 1vseYd-00000000LiL-35nU; Wed, 18 Feb 2026 11:13:23 +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 smtp1.osuosl.org EAC23810B4", "OpenDKIM Filter v2.11.0 smtp2.osuosl.org 0F8D84009A" ], "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=osuosl.org;\n\ts=default; t=1771409613;\n\tbh=kecqzCd+FZoNOUKJXSTKSeC+z7ee4jW/GR0X8AqLv1A=;\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=6xwHbyDKGVDGfNNtHV62+lIbEHlwYqxJlHieXDm26RbDRi6iZ/PNVVx6vivKtUxE/\n\t ZCQYJ18/hwP/fCsqyHljr1oVXZtcIkPxLHTOjLOaG5Tv0j7xJlvDZjunUgaeGzSr5u\n\t Nm7M4rdgRe8+GqKgdnAsbhPMAQ37m9KQiyLlcNu67vNiuOqxdOA7rZJggI3OSIu6x+\n\t feD/aZk2m2Okiaan3Zt65EuOZ8qmXcwOC4kbl0jBjsqb784eBX11MKq32ai9dPajBr\n\t fFrsVFG7xUyg3TYidfru1bJYfmJKNgW6U8pG0t/05e3txO3C60hoIPhLf2pz0HNeox\n\t UHZMBYlh/28Hg==", "Received-SPF": "Pass (mailfrom) identity=mailfrom; client-ip=172.234.252.31;\n helo=sea.source.kernel.org; envelope-from=mchehab+huawei@kernel.org;\n receiver=<UNKNOWN>", "DMARC-Filter": "OpenDMARC Filter v1.4.2 smtp2.osuosl.org 0F8D84009A", "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>", "Date": "Wed, 18 Feb 2026 11:12:50 +0100", "Message-ID": "\n <cee0338b152e57b841664bde9081db6f34ad5d33.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=1771409605;\n bh=ioLa9q6sJJTF/v+qVABuiOCGnewuHvVB07azO/umkxY=;\n h=From:To:Cc:Subject:Date:In-Reply-To:References:From;\n b=W2N8KsPyCPQzPnyyt5iGff8DGM/cK2sbMIH/1bvBNlb9V4D+29hAtxEEGQd3oPOnf\n C7xguU0Bc3PuPgb58uaRtNHDC5pI2XJ/gbpre0laoi4FfhdcqKOO66NykdGAiqXhaW\n xcJ12qRF8F5V6uKY86OvjofQJXS+IwVpUcDB0d6G72OA/rXHJKrzSdHKutEVsMBocC\n eVrQtYGIv6m5nRmSuJsioZds4HXl1GnWxKO92Lntgbwt+yM1pUm3BgK+3hTBnsUo8U\n M3AVqqBoOkwdHNyUa74CKCdOPfeHV33D5Kmz9WJ1gXsJ8H2ibOF7ipyaQT5kOgJiIx\n DC7V6XsME1wAg==", "X-Mailman-Original-Authentication-Results": [ "smtp2.osuosl.org;\n dmarc=pass (p=quarantine dis=none)\n header.from=kernel.org", "smtp2.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=W2N8KsPy" ], "Subject": "[Intel-wired-lan] [PATCH 20/38] docs: kdoc_re: add support on\n NestedMatch for argument replacement", "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": "Currently, NestedMatch has very limited support for aguments\nreplacement: it is all or nothing.\n\nAdd support to allow replacing individual arguments as well.\n\nSigned-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>\nReviewed-by: Aleksandr Loktionov <aleksandr.loktionov@intel.com>\n---\n tools/lib/python/kdoc/kdoc_re.py | 84 ++++++++++++++++++++++----------\n 1 file changed, 59 insertions(+), 25 deletions(-)", "diff": "diff --git a/tools/lib/python/kdoc/kdoc_re.py b/tools/lib/python/kdoc/kdoc_re.py\nindex fed9894a5c71..05f36d665b70 100644\n--- a/tools/lib/python/kdoc/kdoc_re.py\n+++ b/tools/lib/python/kdoc/kdoc_re.py\n@@ -177,29 +177,6 @@ class NestedMatch:\n will ignore the search string.\n \"\"\"\n \n- # TODO: make NestedMatch handle multiple match groups\n- #\n- # Right now, regular expressions to match it are defined only up to\n- # the start delimiter, e.g.:\n- #\n- # \\bSTRUCT_GROUP\\(\n- #\n- # is similar to: STRUCT_GROUP\\((.*)\\)\n- # except that the content inside the match group is delimiter-aligned.\n- #\n- # The content inside parentheses is converted into a single replace\n- # group (e.g. r`\\1').\n- #\n- # It would be nice to change such definition to support multiple\n- # match groups, allowing a regex equivalent to:\n- #\n- # FOO\\((.*), (.*), (.*)\\)\n- #\n- # it is probably easier to define it not as a regular expression, but\n- # with some lexical definition like:\n- #\n- # FOO(arg1, arg2, arg3)\n-\n def __init__(self, regex):\n self.regex = KernRe(regex)\n \n@@ -285,6 +262,59 @@ class NestedMatch:\n \n yield line[t[0]:t[2]]\n \n+ @staticmethod\n+ def _split_args(all_args, delim=\",\"):\n+ \"\"\"\n+ Helper method to split comma-separated function arguments\n+ or struct elements, if delim is set to \";\".\n+\n+ It returns a list of arguments that can be used later on by\n+ the sub() method.\n+ \"\"\"\n+ args = [all_args]\n+ stack = []\n+ arg_start = 0\n+ string_char = None\n+ escape = False\n+\n+ for idx, d in enumerate(all_args):\n+ if escape:\n+ escape = False\n+ continue\n+\n+ if string_char:\n+ if d == '\\\\':\n+ escape = True\n+ elif d == string_char:\n+ string_char = None\n+\n+ continue\n+\n+ if d in ('\"', \"'\"):\n+ string_char = d\n+ continue\n+\n+ if d in DELIMITER_PAIRS:\n+ end = DELIMITER_PAIRS[d]\n+\n+ stack.append(end)\n+ continue\n+\n+ if stack and d == stack[-1]:\n+ stack.pop()\n+ continue\n+\n+ if d == delim and not stack:\n+ args.append(all_args[arg_start:idx].strip())\n+ arg_start = idx + 1\n+\n+ # Add the last argument (if any)\n+ last = all_args[arg_start:].strip()\n+ if last:\n+ args.append(last)\n+\n+ return args\n+\n def sub(self, sub, line, count=0):\n \"\"\"\n This is similar to re.sub:\n@@ -313,9 +343,13 @@ class NestedMatch:\n # Value, ignoring start/end delimiters\n value = line[end:pos - 1]\n \n- # replaces \\0 at the sub string, if \\0 is used there\n+ # replace arguments\n new_sub = sub\n- new_sub = new_sub.replace(r'\\0', value)\n+ if \"\\\\\" in sub:\n+ args = self._split_args(value)\n+\n+ new_sub = re.sub(r'\\\\(\\d+)',\n+ lambda m: args[int(m.group(1))], new_sub)\n \n out += new_sub\n \n", "prefixes": [ "20/38" ] }