Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/1.0/patches/2197666/?format=api
{ "id": 2197666, "url": "http://patchwork.ozlabs.org/api/1.0/patches/2197666/?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": "<dcc7905c09451bb40352426471070c6ca971204b.1771408406.git.mchehab+huawei@kernel.org>", "date": "2026-02-18T10:12:47", "name": "[17/38] docs: kdoc_re: don't recompile NestedMatch regex every time", "commit_ref": null, "pull_url": null, "state": "handled-elsewhere", "archived": false, "hash": "389bbb6b4de6e89869d1ca1d88ce6c394b2bd97c", "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/dcc7905c09451bb40352426471070c6ca971204b.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/2197666/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=Lamj4Wp7;\n\tdkim-atps=neutral", "legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=osuosl.org\n (client-ip=140.211.166.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 [140.211.166.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 4fGC5b6hltz1xpl\n\tfor <incoming@patchwork.ozlabs.org>; Wed, 18 Feb 2026 21:13:39 +1100 (AEDT)", "from localhost (localhost [127.0.0.1])\n\tby smtp1.osuosl.org (Postfix) with ESMTP id E44CC8108F;\n\tWed, 18 Feb 2026 10:13:35 +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 uXps9nPJYGEn; Wed, 18 Feb 2026 10:13:34 +0000 (UTC)", "from lists1.osuosl.org (lists1.osuosl.org [140.211.166.142])\n\tby smtp1.osuosl.org (Postfix) with ESMTP id 0AE94810B4;\n\tWed, 18 Feb 2026 10:13:34 +0000 (UTC)", "from smtp3.osuosl.org (smtp3.osuosl.org [140.211.166.136])\n by lists1.osuosl.org (Postfix) with ESMTP id 4D692206\n for <intel-wired-lan@lists.osuosl.org>; Wed, 18 Feb 2026 10:13:27 +0000 (UTC)", "from localhost (localhost [127.0.0.1])\n by smtp3.osuosl.org (Postfix) with ESMTP id 4A60660789\n for <intel-wired-lan@lists.osuosl.org>; Wed, 18 Feb 2026 10:13:27 +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 ecuDiO-RmTsX for <intel-wired-lan@lists.osuosl.org>;\n Wed, 18 Feb 2026 10:13:25 +0000 (UTC)", "from tor.source.kernel.org (tor.source.kernel.org [172.105.4.254])\n by smtp3.osuosl.org (Postfix) with ESMTPS id 381E760650\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 tor.source.kernel.org (Postfix) with ESMTP id 5E6046132F;\n Wed, 18 Feb 2026 10:13:24 +0000 (UTC)", "by smtp.kernel.org (Postfix) with ESMTPSA id 13517C19421;\n Wed, 18 Feb 2026 10:13:24 +0000 (UTC)", "from mchehab by mail.kernel.org with local (Exim 4.99.1)\n (envelope-from <mchehab+huawei@kernel.org>)\n id 1vseYc-00000000LeR-1Ov7; Wed, 18 Feb 2026 11:13:22 +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 0AE94810B4", "OpenDKIM Filter v2.11.0 smtp3.osuosl.org 381E760650" ], "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=osuosl.org;\n\ts=default; t=1771409614;\n\tbh=PPWEjSDx+/r5pd7Nb+veti7WZxZORWZjuJYeDQhcZNQ=;\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=Lamj4Wp7yJ8HGJfiRik9LItyORDpi/ZhaLju6PI18Iuh33IkyJEmiI5vplmHEn4sM\n\t kxAy40SKLMLZpvJoYQ82OO85hGB4ZVSu9J1NNfd064qjN5FReV96lqSJzTaYX5Y9Y4\n\t J+HLmJsIXPohAgZVF7GhpBsf6AIh8TYZo53MXnvXiZVajSE4tZlntHshMK08jexxaU\n\t Kg/jYFSK3Eu//Aqa4AiaD2lvKCz03PE7yeRz9yZfpPVLAQ3/tvVvbXOnC+i1KzPjC0\n\t ClDtulSFbWXUrUKgeTpNow8taddsB8rBwIY+VojUplJwat/ACuqmLUTEOoqnl6dQAE\n\t 0Uw2FoHekva0w==", "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 smtp3.osuosl.org 381E760650", "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:47 +0100", "Message-ID": "\n <dcc7905c09451bb40352426471070c6ca971204b.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=1771409604;\n bh=G52yNr/mjvH//WKN8I/I22tm0myDjYubrgazvSxDbzk=;\n h=From:To:Cc:Subject:Date:In-Reply-To:References:From;\n b=YMZkDkUW13zBaRg7DOfUhjHz71unx7NaI6RyqKBl3SEQOD8c29gIcsjTXOy1Z9i2n\n 2Vakk440FbQguwYA+zpIKJOjV7418Okmq12espAksvQcRoemC3UF3ui4cWvKlhcwVT\n hLstPo4SK3w54q8W/Kwf53vmWMyv2tjA/FkMviJVveDHZjYTXX8uFnEo/D0i/Zg0Ft\n jBTtnLfbrlwy1YCNdCXx8/lF6PjLjeJWllaEaa28iJEG1PGSVnZiYTcX28bqzPeAVE\n S1hSlv2c8X7TdkjzC/DUP5X7SVle6Yrd04Hj1SpLw5Bual6mHAl/QTkBsm+jwYApZH\n C7nrIM/Wa/6YQ==", "X-Mailman-Original-Authentication-Results": [ "smtp3.osuosl.org;\n dmarc=pass (p=quarantine dis=none)\n header.from=kernel.org", "smtp3.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=YMZkDkUW" ], "Subject": "[Intel-wired-lan] [PATCH 17/38] docs: kdoc_re: don't recompile\n NestedMatch regex every time", "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": "Store delimiters and its regex-compiled version as const vars.\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 | 35 ++++++++++++++++++++------------\n 1 file changed, 22 insertions(+), 13 deletions(-)", "diff": "diff --git a/tools/lib/python/kdoc/kdoc_re.py b/tools/lib/python/kdoc/kdoc_re.py\nindex 0a7f12616f9f..00afa5bccd6d 100644\n--- a/tools/lib/python/kdoc/kdoc_re.py\n+++ b/tools/lib/python/kdoc/kdoc_re.py\n@@ -99,6 +99,13 @@ class KernRe:\n self.last_match = self.regex.search(string)\n return self.last_match\n \n+ def finditer(self, string):\n+ \"\"\"\n+ Alias to re.finditer.\n+ \"\"\"\n+\n+ return self.regex.finditer(string)\n+\n def findall(self, string):\n \"\"\"\n Alias to re.findall.\n@@ -134,6 +141,16 @@ class KernRe:\n \n return self.last_match.groups()\n \n+#: Nested delimited pairs (brackets and parenthesis)\n+DELIMITER_PAIRS = {\n+ '{': '}',\n+ '(': ')',\n+ '[': ']',\n+}\n+\n+#: compiled delimiters\n+RE_DELIM = KernRe(r'[\\{\\}\\[\\]\\(\\)]')\n+\n \n class NestedMatch:\n \"\"\"\n@@ -183,14 +200,6 @@ class NestedMatch:\n #\n # FOO(arg1, arg2, arg3)\n \n- DELIMITER_PAIRS = {\n- '{': '}',\n- '(': ')',\n- '[': ']',\n- }\n-\n- RE_DELIM = re.compile(r'[\\{\\}\\[\\]\\(\\)]')\n-\n def _search(self, regex, line):\n \"\"\"\n Finds paired blocks for a regex that ends with a delimiter.\n@@ -220,13 +229,13 @@ class NestedMatch:\n escape = False\n \n d = line[offset - 1]\n- if d not in self.DELIMITER_PAIRS:\n+ if d not in DELIMITER_PAIRS:\n continue\n \n- end = self.DELIMITER_PAIRS[d]\n+ end = DELIMITER_PAIRS[d]\n stack.append(end)\n \n- for match in self.RE_DELIM.finditer(line[offset:]):\n+ for match in RE_DELIM.finditer(line[offset:]):\n pos = match.start() + offset\n \n d = line[pos]\n@@ -247,8 +256,8 @@ class NestedMatch:\n string_char = d\n continue\n \n- if d in self.DELIMITER_PAIRS:\n- end = self.DELIMITER_PAIRS[d]\n+ if d in DELIMITER_PAIRS:\n+ end = DELIMITER_PAIRS[d]\n \n stack.append(end)\n continue\n", "prefixes": [ "17/38" ] }