From nobody Mon Sep 28 23:51:13 2026 Received: from mail-wm1-f45.google.com (mail-wm1-f45.google.com [209.85.128.45]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 347E31C2324 for ; Sat, 15 Aug 2026 01:33:06 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.45 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1786757587; cv=none; b=QGI0GD1DsB61aYsX/xwOYxr+BmV+7uZeT+l4p7KctP4fUw0ZKvSyGClyxoRELxeBUL3al/BPZdIlJgnE2EyXWWS4qHgIeeXNWYmOsUUh1iPeMZiuM+aL3HNctHFdsQvSyI3g6C/YoQRUsIDDSDZb6eGMuUalFzTN4mON2L+ZGwM= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1786757587; c=relaxed/simple; bh=k5v9YMbjNbSDDOOGUT/GdP8HfTxzzdlrDdwtaQ4IVr0=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=tqymKb7MEztSR7PA+dXopbX6y2SsKb7Ik/x7BbtKyxk1jSgvg4Cc+U7kQEIE4qVj9l6l/QQncRNmjMeeSeXm9iAE7ZATsBKf+Vj7NO9uXPygSC1sEEftt/5T1rZ5GU/AAH25AidVraU/n22R2dXho7hlJuCrY3XZDluEHVKxWow= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=knRa3gu4; arc=none smtp.client-ip=209.85.128.45 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="knRa3gu4" Received: by mail-wm1-f45.google.com with SMTP id 5b1f17b1804b1-495757ccbc1so14294985e9.2 for ; Fri, 14 Aug 2026 18:33:05 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1786757584; x=1787362384; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to:content-type; bh=SIGYB4s+r27dzXsvVBxWuaiKhOOlGAnsc8iJP12SM18=; b=knRa3gu4IJLqvEV49+J/h2US2KsqLW68pQepMRpFuoL2Fz+9QI0FxWl0uBxIzIEzZ6 9S/eH3KfZrYTxjW8vO99ieK4D7J+0xj4e9PlZgawwOtsM+i7QbWD37z92cVJ06DiGpwQ hDrntog23N/4o/51/LEqRArElEKfCou5316daAS8yDD0MoA30heWyO0swlz4SiqWGCoa +HLBaKTwfxa4qe79Ns4aBS3bt9AtaOl+hmXuaAYQRa/7zOqI40bUS7nYmjWbWCbooPbV MIvpfFD8+ZJqt3jVzX3QIy/CX2JrgX0WdnYT+K3OEKQngrMUy2w3CK8BP5/rELyd526/ h3bg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1786757584; x=1787362384; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to:content-type; bh=SIGYB4s+r27dzXsvVBxWuaiKhOOlGAnsc8iJP12SM18=; b=NW8KPHUGd0rvJipzgjXp8TP+VL4vW/tTR/QpLxQMgDdxUqb2uRFXiTKCq+voKBycXg jKcFuDmdM3WjVE5oPHZbKNRW7fsavp3El7EBCjVu8D3aEKREozHMOUxjNpKd9mdc187Q giWP7n1fzPxBf6j7VZ2FNnTwOI6kFvsnJU7OSDjyofplruT/phpeJuBv6mUUPbaAf7Np zfN6WJHgONIkvR17BTYacqHi9VuiG9l/3+woTLt8YC3OK2fpd1ETwaflcy7pjDVIhOYy VYcYcbFFSMTPHKCswIHAXSnw4uil/3aRKOVrUPCRd6kHiKz5vwqueaCR91gizo4D/sWN QdEQ== X-Forwarded-Encrypted: i=1; AHgh+RpBs76aycr9Pk5nPDW/DdiPolgG69OEumYvDz/MUwoHMye75CoBSJcQP2hpaBTG0V1LlWJZjWBN/rL585Q=@vger.kernel.org X-Gm-Message-State: AOJu0Yxfm/lOyjutHjIZXeg7PDg4VpzE7E1ok2DqhwlheOY/Ot4G/MqZ mGVxHaNfypaUF9C9Um/FGeokM7r/XusX1b9WJQL2K1aVNWu+oFJvDdLI9JNG9Qqv X-Gm-Gg: AR+sD12NeunQ06FHk0VUOg9J/iX5TW8uWKzcIe/z3wXngbm5OuLLJhY6DW1uSGnEJKj mMR+flWLpMOkCPfQYPIIW6ZYMs6n0IAHQqleCOdROjjPlXvUMboOUiBLwhi9k/TRBIVe49kgVtf eNNNiZFWt9ejNrUWgp/W5erd1uPVbD25ZYPpesUHhUk0pYIp42j/gXOU0rdKTDPjStZrFOpFFAF cRzz3uu+i6oYrxmAsHtx03a8nw9ElWJiI+CazILb2yB6MXcdaXZUM8nRgo4OZLkPdSfHTmhVeUN ygASvITL51dEJaouiZf9wNWjbp7e0YgE9ZEs2Zjg2AdWMRYFtodInDyCEP5JYWrFedM740HOoHG a6GF8lGKfb3gbyzLVYLhvnUifwC9vm1ay05khPjnau+BhDTq05iJ4WW5NCsicnZNdveIE4n4UQV qm3dHSxq/lQaYc7BO/xEOKlVeP3iCQUgWh9CzuVd7sjqjo4cFhvIIOOMEJ2CAqsYpXH3aY7uZ/p CWJ0W3lF68IUM/5dDYmeoMCrSbhuQsg4HVvqXHY2tOIbWvxGipdhUkUZtapU4uqGk7PfOWA988r kFMW5pejJgM0QLO0/E+cyZGw3Y0swcEk5+t9HSL6hxthV00QnFjm0ipPlU8e8UpHMBbL X-Received: by 2002:a05:600c:b99:b0:496:c379:b2a1 with SMTP id 5b1f17b1804b1-49987929903mr135321985e9.2.1786757584407; Fri, 14 Aug 2026 18:33:04 -0700 (PDT) Received: from localhost.localdomain (dynamic-2a02-3100-9d7d-f301-9495-44ec-73e6-1be7.310.pool.telefonica.de. [2a02:3100:9d7d:f301:9495:44ec:73e6:1be7]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-49987b1a31esm110672885e9.2.2026.08.14.18.33.02 (version=TLS1_3 cipher=TLS_CHACHA20_POLY1305_SHA256 bits=256/256); Fri, 14 Aug 2026 18:33:03 -0700 (PDT) From: Karl Mehltretter To: "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Mauro Carvalho Chehab , Jonathan Corbet Cc: Karl Mehltretter , Shuah Khan , Simon Horman , Randy Dunlap , netdev@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH net-next v2 1/2] net_shaper: fix kernel-doc list indentation Date: Sat, 15 Aug 2026 03:32:28 +0200 Message-Id: <64f428350ec1450adcd0607f54f30d27a42f129c.1786751700.git.kmehltretter@gmail.com> X-Mailer: git-send-email 2.39.5 (Apple Git-154) In-Reply-To: References: Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Docutils 0.22.4 reports: Documentation/networking/kapi:107: ../include/net/net_shaper.h:82: ERROR: Unexpected indentation. Add the required blank line and correct the list indentation. Assisted-by: Codex:gpt-5.6-sol Signed-off-by: Karl Mehltretter Reviewed-by: Randy Dunlap Tested-by: Randy Dunlap --- include/net/net_shaper.h | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/include/net/net_shaper.h b/include/net/net_shaper.h index 05cb625b0fe54..330517a1cb5c2 100644 --- a/include/net/net_shaper.h +++ b/include/net/net_shaper.h @@ -80,10 +80,11 @@ struct net_shaper { * disallowed at the uAPI level will never be made at the driver level. * The shaper core performs automatic reparenting and cleanup, generating * additional calls. Notably: - * - @group calls in the driver facing API may have nodes as leaves (user= is - * only allowed to construct groups with queues as leaves) - * - @group calls may update leaf's parent if the parent is about - * to be removed (re-parenting nodes explicitly is not supported in the= uAPI) + * + * - @group calls in the driver facing API may have nodes as leaves (user = is + * only allowed to construct groups with queues as leaves) + * - @group calls may update leaf's parent if the parent is about + * to be removed (re-parenting nodes explicitly is not supported in the = uAPI) * * Implicit creation * ----------------- --=20 2.53.0 From nobody Mon Sep 28 23:51:13 2026 Received: from mail-wm1-f47.google.com (mail-wm1-f47.google.com [209.85.128.47]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 00846274B46 for ; Sat, 15 Aug 2026 01:33:10 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.47 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1786757592; cv=none; b=FAVoJr1zpTHYtREglLPBCqZhd2njOLs+NiwAj/HqeS3ZKZLLRgGpjEP2iIpy2MO0C9shI2Gm+BNE8OqZhklPKXDVgoKTP/GQ9a0n6uxPCkK4cxS/f5w9ew+YbkHdNAKtEws1GVc+9Ago9m6Iz+FvvY7kfsKCTSHBD0MHMSq3ofs= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1786757592; c=relaxed/simple; bh=jyYxlbBrAQnAZZN04ajlnh1MSAFrHtyTd0FqLUs6XWo=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=MC73xqdfcMEDS0ES27WKP8xrs+vzJxz5ecS76c6J+Kop3Wie5mKmaVHm1+sMOK9EyYCv372ZMCmX0rKlEr4S9cUaLuD9fBoQsQt+64p/BgGAP0IC3aPJmUL8aHd7XUVJxctljFrN2P5RXwIXfdLDtddfy8Pk8foysyqdz/DhwEU= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=Ve38/Vv6; arc=none smtp.client-ip=209.85.128.47 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="Ve38/Vv6" Received: by mail-wm1-f47.google.com with SMTP id 5b1f17b1804b1-496bb7cdf51so20944915e9.2 for ; Fri, 14 Aug 2026 18:33:10 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1786757589; x=1787362389; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to:content-type; bh=P6hUXHl/XBMGrttNYvWX7RrvTYp0xlm1Orl1JfPmVXo=; b=Ve38/Vv6z0vdVwFjMw4XZ/ku43aAffw/dwkJlQ/JuVcQeJAc7WY0nfMrk5kZmwS94c RFcIQd+iQ7nEh4Um9bAsdvHe+7S1sznMjb1RbB0sMBWRgwV5WMlsAFWppkNUVrHF28ku 6QkSsBCHTh7VuHPtrHDgTiioNM8de+tOalesxRMPz/YyAeGwJHK3oTfazftR2pB4h9RI EMNcU+t2GC8qNO9jCrHO6r91ICWsrBEsrXjOi1s/IVINZNMVAll1cejSJgB+mAC8QSbC cmdwM+aIXIfQlh5EpfvKMELcHR1W7Dni9UYBqFRJhuhbXMteH67wKEGTJehI7Y0sby6a LShA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1786757589; x=1787362389; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to:content-type; bh=P6hUXHl/XBMGrttNYvWX7RrvTYp0xlm1Orl1JfPmVXo=; b=J7xg/KHI9eVRCCJaI2QNhS7Z5nfdiVqKIlTLbOHKaXHLP1FP8jWP5xhTISRhCWTM4+ 56jovXzCqPxNk6JuoSa3jtX9pd5iphfbD7VVLt8scnIN/sh6+AkdKKUB0jpid8TBEzzQ W2tvciTvJ3r4JcJ6dvJfffGRITk+OwevrnD58Mp48fPDQIXvPwsO3rGZmgwCd630F0iv 3roY4F8yasufQ0L/OPfA9eB6kirkjWG+5ECMUmoq9O+8PTuyMNuqqXj0NqD3/XHSc+oU q6I7Rywl239WVGw8ARwqXHwEVRHuleKYYsIP0qIkL8aCa9OVhsSngB/irAvIZkHxUYzQ xy4A== X-Forwarded-Encrypted: i=1; AHgh+RpYe0pkGCS1xy8sxI6RhxkGPV9wqU4J1np0/wuJ/tiQ+QkDyiEQoprgwSXTSGdfrft33H2DeMC9qa4Fgvc=@vger.kernel.org X-Gm-Message-State: AOJu0Yz45LJNZ8V3F+zCyWMgzS7V+9pHIKMamMszg9ZaIsI40WyCf2GO TEMihv9PExjHd98PYjhu8F4ZyALGJ9GPv8YFuZ/3EIfR9MJqNb7wOH0R X-Gm-Gg: AR+sD10ZlIYHcQ0i1RlrRUYR+6mkvhE5/kqF2trTVUTboyx+t9eT/pgp+yH8NM4M95/ gUqvcqULi4Xp6QTVDheNavqjbPmiG0Y44GJcZnFI37Xc/COTw4JzZ3M+YS5yHfQtqtlZ6a94NH3 eETAuYNTJWsENxxwzg/mR/qPs5Dv3IMamEfAZmQxy1KNVLTROWLkgOgxUTygLw3JpPPRCgDw8cX TIlxioawszG5A6sqL3IOPqKAepaUKAw01YrUeu1UhaxrG7SufAimsBGiYVurq+I3J6XfvSz4WmH q4GLIWDea7gy4BK+aDS2Lfvd6yHDutGEsJDRTrA5pRWjO48YxcPEBzV8BEwbN/uwn6YgubJg1jB wgZs7q6dU8DI+4XwwwpCNa5ay4X5KxLy7nnMcVrm0+zfbnrCd9vWNk7cmEQdraS+GYy2pbRkNjq GPEucx1qk1cgLUjh+C2Y54w4f9mvGhV3zAVOmdTb3sybz+86VFfMISdE5qyKNkmRBdFl9Dj4Pb9 QprR8Lzsm9mTXSn9eL0hLaLTa4jnZQm7DCpt+uvhskbVU8Jp26OqFxRCoK2RljnZ65Pe//2gr1A 3grOSKSUq57M4E+9YNAIsOxf972Q0f0r4QmSJa6qZAA5W3RfIBj7wWIxnkxdLm8ejy03aIcDSa7 WlDZs X-Received: by 2002:a7b:c013:0:b0:499:51b8:d649 with SMTP id 5b1f17b1804b1-49987941a3fmr93722545e9.3.1786757588989; Fri, 14 Aug 2026 18:33:08 -0700 (PDT) Received: from localhost.localdomain (dynamic-2a02-3100-9d7d-f301-9495-44ec-73e6-1be7.310.pool.telefonica.de. [2a02:3100:9d7d:f301:9495:44ec:73e6:1be7]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-49987b1a31esm110672885e9.2.2026.08.14.18.33.06 (version=TLS1_3 cipher=TLS_CHACHA20_POLY1305_SHA256 bits=256/256); Fri, 14 Aug 2026 18:33:07 -0700 (PDT) From: Karl Mehltretter To: "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Mauro Carvalho Chehab , Jonathan Corbet Cc: Karl Mehltretter , Shuah Khan , Simon Horman , Randy Dunlap , netdev@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH net-next v2 2/2] docs: kerneldoc.py: preserve headings in kernel-doc output Date: Sat, 15 Aug 2026 03:32:29 +0200 Message-Id: <335fec1cd5a3449687f8b1ee8cd46a0f3e455aa5.1786751700.git.kmehltretter@gmail.com> X-Mailer: git-send-email 2.39.5 (Apple Git-154) In-Reply-To: References: Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" kerneldoc.py parses extracted ReST into a detached section node while retaining the surrounding title hierarchy. Docutils 0.21.2 silently drops affected sections; 0.22.4 reports: Documentation/networking/kapi:107: ../include/net/net_shaper.h:75: ERROR: A level 3 section cannot be used here. The same issue drops three Xe DRM RAS headings already in mainline. Use nested_parse_with_titles() to give kernel-doc output an independent title hierarchy. Fixes: 2404dad1f67f ("doc: Cope with the deprecation of AutoReporter") Assisted-by: Codex:gpt-5.6-sol Signed-off-by: Karl Mehltretter Acked-by: Randy Dunlap Tested-by: Randy Dunlap --- Documentation/sphinx/kerneldoc.py | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/Documentation/sphinx/kerneldoc.py b/Documentation/sphinx/kerne= ldoc.py index c1cadb4eb0997..9986df33e37ea 100644 --- a/Documentation/sphinx/kerneldoc.py +++ b/Documentation/sphinx/kerneldoc.py @@ -38,6 +38,7 @@ from docutils.statemachine import ViewList from docutils.parsers.rst import directives, Directive import sphinx from sphinx.util.docutils import switch_source_input +from sphinx.util.nodes import nested_parse_with_titles from sphinx.util import logging from pprint import pformat =20 @@ -252,7 +253,7 @@ class KernelDocDirective(Directive): =20 def do_parse(self, result, node): with switch_source_input(self.state, result): - self.state.nested_parse(result, 0, node, match_titles=3D1) + nested_parse_with_titles(self.state, result, node) =20 def setup_kfiles(app): global kfiles --=20 2.53.0