{"id":2197668,"url":"http://patchwork.ozlabs.org/api/1.0/patches/2197668/?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":"<7b6f6ba86ebeab3d62735eb5b851631d042a361c.1771408406.git.mchehab+huawei@kernel.org>","date":"2026-02-18T10:12:55","name":"[25/38] docs: kdoc_parser: minimize differences with struct_group_tagged","commit_ref":null,"pull_url":null,"state":"handled-elsewhere","archived":false,"hash":"353daba05813333515b694ca95cde258139413d9","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/7b6f6ba86ebeab3d62735eb5b851631d042a361c.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/2197668/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=qz8Lmc8q;\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 4fGC5c2pp3z1xyD\n\tfor ; Wed, 18 Feb 2026 21:13:40 +1100 (AEDT)","from localhost (localhost [127.0.0.1])\n\tby smtp3.osuosl.org (Postfix) with ESMTP id BC96860804;\n\tWed, 18 Feb 2026 10:13:37 +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 J_Ctwg5JpbwD; Wed, 18 Feb 2026 10:13:37 +0000 (UTC)","from lists1.osuosl.org (lists1.osuosl.org [140.211.166.142])\n\tby smtp3.osuosl.org (Postfix) with ESMTP id 355B360802;\n\tWed, 18 Feb 2026 10:13:37 +0000 (UTC)","from smtp1.osuosl.org (smtp1.osuosl.org [IPv6:2605:bc80:3010::138])\n by lists1.osuosl.org (Postfix) with ESMTP id 28158206\n for ; Wed, 18 Feb 2026 10:13:29 +0000 (UTC)","from localhost (localhost [127.0.0.1])\n by smtp1.osuosl.org (Postfix) with ESMTP id D62E7810A1\n for ; Wed, 18 Feb 2026 10:13:28 +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 HgzMC5nDpHCO for ;\n Wed, 18 Feb 2026 10:13:28 +0000 (UTC)","from sea.source.kernel.org (sea.source.kernel.org\n [IPv6:2600:3c0a:e001:78e:0:1991:8:25])\n by smtp1.osuosl.org (Postfix) with ESMTPS id EC26F810A0\n for ; Wed, 18 Feb 2026 10:13:27 +0000 (UTC)","from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58])\n by sea.source.kernel.org (Postfix) with ESMTP id A64BF4458A;\n Wed, 18 Feb 2026 10:13:27 +0000 (UTC)","by smtp.kernel.org (Postfix) with ESMTPSA id 8ACFAC19423;\n Wed, 18 Feb 2026 10:13:27 +0000 (UTC)","from mchehab by mail.kernel.org with local (Exim 4.99.1)\n (envelope-from )\n id 1vseYf-00000000Loe-3OFS; 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 smtp3.osuosl.org 355B360802","OpenDKIM Filter v2.11.0 smtp1.osuosl.org EC26F810A0"],"DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed; d=osuosl.org;\n\ts=default; t=1771409617;\n\tbh=RzNbhSVGTN6Ot4UdSIbnGCZIvIaZZzauEnU2AYtuMnM=;\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=qz8Lmc8qwOWQAQ+aZBMw4joyFQlms/kSrTOHwQxkBpIfTJ37SrADCw7doXVPMfcRL\n\t 6yu2h1YfxjE1VaZGC5Wbax/a3raybA+EC6itE9lVdGiGgLK3prGu/MbpqycyWZpxU1\n\t e+I5wWLKwV4rMZIRMYqcyx/Q4icKMr5JcsaTgl7dF1qI7C6qQgg0Yq62H5g8Yzbd5r\n\t pFrc3aXbITA7P0a0SD+/L3AccMCHfnDAhrjQLELryQ6vVZOON6ryM3RRFE0kXVUV9d\n\t XDQJyeHOFHMFMvHKh4YhnS6t6bKScIpdfc7KgD+goH01Fp3mcYDi5ozoKkNBUBAj+p\n\t u9aIm9Q8fcqjw==","Received-SPF":"Pass (mailfrom) identity=mailfrom;\n client-ip=2600:3c0a:e001:78e:0:1991:8:25; helo=sea.source.kernel.org;\n envelope-from=mchehab+huawei@kernel.org; receiver=","DMARC-Filter":"OpenDMARC Filter v1.4.2 smtp1.osuosl.org EC26F810A0","From":"Mauro Carvalho Chehab ","To":"Alexander Lobakin ,\n 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:55 +0100","Message-ID":"\n <7b6f6ba86ebeab3d62735eb5b851631d042a361c.1771408406.git.mchehab+huawei@kernel.org>","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=1771409607;\n bh=ClRhaNpIRp4d1LeCk51dHxLXX4FD+ZDnmDB3anBLh9o=;\n h=From:To:Cc:Subject:Date:In-Reply-To:References:From;\n b=E4jW1HQEiNJGt9nxlWI7HPbPRCzBmC2z4/0V+SKXwbQCMFGfYkQQdUPUjxfK1785C\n 8peGmSJYA1db+nfNkQZMKfH8b2Jx6r0pjKIdjcmerVlhmbqNBDlRsD2+rdABgs2eiR\n dPC5cgWXdTKvgafq8jxD1ZeEdx0Xg6icPuDtdvyKN56CaKv0d/rOZIPUKwMZAPrOX5\n ZsSIDLz68gsR3V/uCbF1dfdeYRAIWg9Kt1L5UnaW9MkDpZdowBgPVyvnbjpw7tRCzX\n x24RT1AdesyHRv3ptd19n8jamK067eY76BDnbcadlv/NTBPSMYfPhO3lByB7I9VNp9\n 8CEgVb48qVKBg==","X-Mailman-Original-Authentication-Results":["smtp1.osuosl.org;\n dmarc=pass (p=quarantine dis=none)\n header.from=kernel.org","smtp1.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=E4jW1HQE"],"Subject":"[Intel-wired-lan] [PATCH 25/38] docs: kdoc_parser: minimize\n differences with struct_group_tagged","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":"While the previous version does a better job representing\nthe actual struct, it ends losing documentation from each\nmember.\n\nChange the replacements to minimize such changes. With that,\nthe only differences before/after using NestedMatch new\nreplacement logic are (at man page output):\n\n --- before.log 2026-01-29 06:14:20.163592584 +0100\n +++ after.log 2026-01-29 06:32:04.811370234 +0100\n @@ -1573701 +1573701 @@\n -.BI \" struct ice_health_tx_hang_buf tx_hang_buf;\"\n +.BI \" struct ice_health_tx_hang_buf tx_hang_buf;\"\n @@ -4156451 +4156451 @@\n -.BI \" struct libeth_fq_fp fp;\"\n +.BI \" struct libeth_fq_fp fp;\"\n @@ -4164041 +4164041 @@\n -.BI \" struct libeth_xskfq_fp fp;\"\n +.BI \" struct libeth_xskfq_fp fp;\"\n @@ -4269434 +4269434 @@\n -.BI \" struct page_pool_params_fast fast;\"\n +.BI \" struct page_pool_params_fast fast;\"\n @@ -4269452 +4269452 @@\n -.BI \" struct page_pool_params_slow slow;\"\n +.BI \" struct page_pool_params_slow slow;\"\n @@ -4269454 +4269454 @@\n -.BI \" STRUCT_GROUP( struct net_device *netdev;\"\n +.BI \" struct net_device *netdev;\"\n\ne.g. basically whitespaces, plus a fix NestedMatch to\nbetter handle /* private */ comments.\n\nSigned-off-by: Mauro Carvalho Chehab \nReviewed-by: Aleksandr Loktionov \n---\n tools/lib/python/kdoc/kdoc_parser.py | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)","diff":"diff --git a/tools/lib/python/kdoc/kdoc_parser.py b/tools/lib/python/kdoc/kdoc_parser.py\nindex e1914b2a6ab7..e735e79b5061 100644\n--- a/tools/lib/python/kdoc/kdoc_parser.py\n+++ b/tools/lib/python/kdoc/kdoc_parser.py\n@@ -126,7 +126,7 @@ struct_xforms = [\n #\n (CFunction('struct_group'), r'\\2'),\n (CFunction('struct_group_attr'), r'\\3'),\n- (CFunction('struct_group_tagged'), r'struct \\1 { \\3 } \\2;'),\n+ (CFunction('struct_group_tagged'), r'struct \\1 \\2; \\3'),\n (CFunction('__struct_group'), r'\\4'),\n \n #\n","prefixes":["25/38"]}