{"id":2197669,"url":"http://patchwork.ozlabs.org/api/1.0/patches/2197669/?format=json","project":{"id":46,"url":"http://patchwork.ozlabs.org/api/1.0/projects/46/?format=json","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":"","date":"2026-02-18T10:12:53","name":"[23/38] docs: kdoc_re: add a helper class to declare C function matches","commit_ref":null,"pull_url":null,"state":"handled-elsewhere","archived":false,"hash":"d44f7c42c282f63b49ad3abdbd3fbc509e3d72ea","submitter":{"id":78235,"url":"http://patchwork.ozlabs.org/api/1.0/people/78235/?format=json","name":"Mauro Carvalho Chehab","email":"mchehab+huawei@kernel.org"},"delegate":null,"mbox":"http://patchwork.ozlabs.org/project/intel-wired-lan/patch/a20aa001f4a0c8051f2d004aa21ca73d1db14613.1771408406.git.mchehab+huawei@kernel.org/mbox/","series":[{"id":492532,"url":"http://patchwork.ozlabs.org/api/1.0/series/492532/?format=json","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/2197669/checks/","tags":{},"headers":{"Return-Path":"","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=8Wa3XNd/;\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 4fGC5f2kX9z1xpl\n\tfor ; Wed, 18 Feb 2026 21:13:42 +1100 (AEDT)","from localhost (localhost [127.0.0.1])\n\tby smtp1.osuosl.org (Postfix) with ESMTP id 1C94A810B6;\n\tWed, 18 Feb 2026 10:13:38 +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 RYAdY_vyzD8Z; Wed, 18 Feb 2026 10:13:36 +0000 (UTC)","from lists1.osuosl.org (lists1.osuosl.org [140.211.166.142])\n\tby smtp1.osuosl.org (Postfix) with ESMTP id E900681091;\n\tWed, 18 Feb 2026 10:13:35 +0000 (UTC)","from smtp2.osuosl.org (smtp2.osuosl.org [IPv6:2605:bc80:3010::133])\n by lists1.osuosl.org (Postfix) with ESMTP id 21C21206\n for ; Wed, 18 Feb 2026 10:13:28 +0000 (UTC)","from localhost (localhost [127.0.0.1])\n by smtp2.osuosl.org (Postfix) with ESMTP id 07F9940078\n for ; Wed, 18 Feb 2026 10:13:28 +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 LiFOSD8Y2hDM for ;\n Wed, 18 Feb 2026 10:13:27 +0000 (UTC)","from sea.source.kernel.org (sea.source.kernel.org [172.234.252.31])\n by smtp2.osuosl.org (Postfix) with ESMTPS id 156EB4009A\n for ; Wed, 18 Feb 2026 10:13:26 +0000 (UTC)","from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58])\n by sea.source.kernel.org (Postfix) with ESMTP id CF6494454A;\n Wed, 18 Feb 2026 10:13:26 +0000 (UTC)","by smtp.kernel.org (Postfix) with ESMTPSA id AFFA8C19421;\n Wed, 18 Feb 2026 10:13:26 +0000 (UTC)","from mchehab by mail.kernel.org with local (Exim 4.99.1)\n (envelope-from )\n id 1vseYf-00000000Llw-00lq; Wed, 18 Feb 2026 11:13:25 +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= ","DKIM-Filter":["OpenDKIM Filter v2.11.0 smtp1.osuosl.org E900681091","OpenDKIM Filter v2.11.0 smtp2.osuosl.org 156EB4009A"],"DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed; d=osuosl.org;\n\ts=default; t=1771409616;\n\tbh=tJlcHrphR51KQpBCcCcntFwPplpVoyviuJh7PqibIcI=;\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=8Wa3XNd/qtpW4MQ0k+NnYxz/HAMEEc/osDz4/qOEtXZY/ZL+O3SKJ7F+QLJ/vI7b7\n\t lhgpxKfqVmvxmn992KR8+CjttB0osFYb4TU1MlJi1Qq5soDLZfPm9yW2mHvSbr2D+R\n\t 5ipWngAe5fKkEvTtEsqoRzX5kGrkMenlwyxZ12K13bUKVh6ShaCMSdaCrnyyzbRW1L\n\t rAdYDtf7Bk8wOzqnknXIEO8O22muzrsXdd2mZAxzMQgtbut+2VxBe78HjiHOFwX4Zg\n\t hhFEL4wo6T35/EvJ7jas0v9NW7H7MEpcZ51kY6kXkyNLCWvGU27Nht12rKZDA0PV2+\n\t y0MF8Vel+jFfA==","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=","DMARC-Filter":"OpenDMARC Filter v1.4.2 smtp2.osuosl.org 156EB4009A","From":"Mauro Carvalho Chehab ","To":"Jonathan Corbet ,\n Linux Doc Mailing List ","Cc":"Mauro Carvalho Chehab ,\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 ,\n Randy Dunlap ","Date":"Wed, 18 Feb 2026 11:12:53 +0100","Message-ID":"\n ","X-Mailer":"git-send-email 2.52.0","In-Reply-To":"","References":"","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=1771409606;\n bh=86xDsz00XoZv72qsVxrMGG+DckqmwvjpK6jYFBlRKlc=;\n h=From:To:Cc:Subject:Date:In-Reply-To:References:From;\n b=iJgsNj1ILFH/W404vgqOOGidsNLkMe7JdUEX16v4Uau/P2nB9asfrZh/MsBF6mG1p\n +dXmaF+m95974ysB4gS0Hdt73+2d0dETu3C4BvovzUrKcfvucv2NqxnM0kbuNcv1g+\n yT/AEh39PjncL/tuEIYKGo6UfJVkKSh/W04IAWASLWUxWHrSokyUNVLThZiCIwgSNP\n X9tTUZq41lIw4eb4XKnGUr+/yWpCMbdQEU2VHjZh3G+tRj4bD+P1j/DRuPgijn6vW8\n wczH34zjTznei9NFRqdXI6agVnpnSHAK5GvxBwwPB9G3X5Msy+nfKKFHtdlRFHwpo0\n YlzAUxHzoIZAw==","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=iJgsNj1I"],"Subject":"[Intel-wired-lan] [PATCH 23/38] docs: kdoc_re: add a helper class\n to declare C function matches","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 ","List-Unsubscribe":",\n ","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n ","Errors-To":"intel-wired-lan-bounces@osuosl.org","Sender":"\"Intel-wired-lan\" "},"content":"Add a more convenient class to match C functions and avoiding\nissues at the beginning and ending of NestedMatch inits.\n\nSigned-off-by: Mauro Carvalho Chehab \nReviewed-by: Aleksandr Loktionov \n---\n tools/lib/python/kdoc/kdoc_re.py | 11 +++++++++++\n 1 file changed, 11 insertions(+)","diff":"diff --git a/tools/lib/python/kdoc/kdoc_re.py b/tools/lib/python/kdoc/kdoc_re.py\nindex cdc842f5fc8f..f72b80ea4f1b 100644\n--- a/tools/lib/python/kdoc/kdoc_re.py\n+++ b/tools/lib/python/kdoc/kdoc_re.py\n@@ -383,3 +383,14 @@ class NestedMatch:\n \"\"\"\n \n return f'NestedMatch(\"{self.regex.regex.pattern}\")'\n+\n+\n+class CFunction(NestedMatch):\n+ r\"\"\"\n+ Variant of NestedMatch.\n+\n+ It overrides the init method to ensure that the regular expression will\n+ start with a ``\\b`` and end with a C function delimiter (open parenthesis).\n+ \"\"\"\n+ def __init__(self, regex):\n+ self.regex = KernRe(r\"\\b\" + regex + r\"\\s*\\(\")\n","prefixes":["23/38"]}