From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-wm1-f54.google.com (mail-wm1-f54.google.com [209.85.128.54]) (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 532C3156F45 for ; Sat, 15 Aug 2026 01:33:00 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.54 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1786757581; cv=none; b=phjpMiwq0pPrDqxra6o1PPA3W/zmSRkEIJh6VmKUFMGVBxYkfAqT5nWtYD2SpKLQ5fPZIKVkGiYvcjhpassCr7pAewvEsH+VKDo4Jq/Q47IZVPll2UEJK99RBik000mS72Ot7908Flv6dXmngr3ebuUqpMTodPvHva4kmTeOfQM= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1786757581; c=relaxed/simple; bh=mDgAsKs6meo//NBXXLbI4OKPjgjud9Wvq+usYByvNDk=; h=From:To:Cc:Subject:Date:Message-Id:MIME-Version; b=fo95zuv+LCO6rCxX43V0My5IFV3+Cg1AvJcveDJ9Tk+Vl0tSdEh8YPBjT7g6SM6tn4cl6qdCGt1PXm+nrBro3pxCKC3Vx/PqKpd+S7hgIbGaZ9x34r+CeK8FVlngjjZMC6abvDI1uIYj+41BCOlZ1FHEh/wph/W5WFbRnPFklxA= 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=K5a5Jwzw; arc=none smtp.client-ip=209.85.128.54 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="K5a5Jwzw" Received: by mail-wm1-f54.google.com with SMTP id 5b1f17b1804b1-49987fb18c0so7334565e9.3 for ; Fri, 14 Aug 2026 18:33:00 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1786757578; x=1787362378; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to:content-type; bh=b+EBtOS3yArt80y5oN+qnjKWVwEXEBrwucchm/mxHIo=; b=K5a5Jwzw3tm37oBhTUkKHQMR82eb1IGEfsZ1l18+RcsHFlgC+4on6OooCAZmQF+vJl B7lojnRhXV852EbJyAamAR3NTRkuz5hRWJbQ50mWLtC6oZtQDdRKErgXaWtd+rjEk7iM Gq6wJkCZHvkBg22ZfaUilig+7Y3lWXKMKmDO/uGdyq4/P1/pUM7ccYS4DRUKnQDozMRK OU5OTyPtgMTtJDcF/CdbMU218X4kcQ2HgGlTfy/Z7e7srxjecaZ5oxuUcfNmuqVFTxi/ rS1Cga+rSS/oKfWwJFwTfvFXBMBoX/IpUT7h2u7fqBOaXhiyHIVck3i3RQgs7y1mfjRA W0+g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1786757578; x=1787362378; h=content-transfer-encoding:mime-version: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=b+EBtOS3yArt80y5oN+qnjKWVwEXEBrwucchm/mxHIo=; b=Tdjhy/vcyul9315sgiJCjgFrphH4V1Pp/gZcgXhanm/qCyzxcHP7rUNFxkgJIPe5Hl +dehgdbfNv1OHQvHcrxuukteg6u+QX60BKNv5G4vuQbMU9D6zYBwAHCYLvL+3J/KwyE3 L4ERZggs+9YcBMOxtPtwsQynoCA69XEpRjMp9Xk7DMtyH/CeO4ZJKyKjQ/0FCoiz+nJ+ gm/VTEWR49ENQQL/7jWPRMF3jykVxiYKfNGzpmc0OVU9g+qYO+/mPZmBn407gp47ujNU 4HVKk2uGIsNw7UIHjMFPkq/X/UGsS4o97eisyrRn5efq+Je8koH7K29onV5FbCJDh7q7 s7kw== X-Forwarded-Encrypted: i=1; AHgh+Rp9gGDVmI2UG0CUtgA9w7WVdt58jAt6H/BuR+xHv1H4FEDFNXxe3bdcY4Z/XPxNDQBCuFmHp0jVCs+eZQM=@vger.kernel.org X-Gm-Message-State: AOJu0YzarcdMaAOGxgrZYExNpd1gvdY635iIzb56A//5W4Fm31e4PIfV jksUPJk/LKD3GE6bfpMw6zGsf0ZM7zbOndrm1heb+nh9B968JHwykzzc X-Gm-Gg: AR+sD10tNYsfLSGc/Jawqv1wVpanUq4iC6B1N6mUtrsintFkfSJQrTOtmzIi85RroRM gTu3+YTcHWKDDXlq0HkRg0IdPxoN/4IxzHCTFS/YY+2mbjqe77UR15KQCY2CQ5aeD3XRvNp8E4i d5302nbQ4Z5d5uF07gxQMpSZrvaYX0mdzGKMEXbwnIGx/xkB7+sTUkGv4gffrS7oOYcaX7qGiRJ QTAG45j07Leh4IXJCvr5aU/6BPBXIqaBEKoPdjkfGsUAb31f+4Y2e9A64iB/ABIoeuP2okxjRFg QV7pRf5zxAacX5AmQcrd076iAlHkD5/j/Oz+97aj5Gsybq+KxnaNkLjF65r/Ye+mSazFaAur3ht x51sHNPTtZDiG+XFT+CXJLjK5sfeKqlxHPIiGLhVN798RaPkvkyPRwZVlhZz+tIrQiui0F5Mj5Z vzGrh2Ydl7Pe+Ehn8D9Hw5aIh/w6ma+hqAtLdsn5M0ydA4KAGHsDW1LJBo1hpaPAzYGqbAmDxxI yIlkxbFbcL/26rlk2gisSo2jOZsdBTGB/UJa9/ZqHB9iM19N/Z4cL/k4PwUF0I/pr2voe6nqnvT WXQrL1MpOMZPiM621gzKGBwdxYwapcVpe17Th4wNnd6ke1Lv+CFBSXuw9PaPgL5dcIV32WmK4zj lMJI= X-Received: by 2002:a05:600c:3491:b0:498:952:e276 with SMTP id 5b1f17b1804b1-499879653bbmr149398885e9.8.1786757578369; Fri, 14 Aug 2026 18:32:58 -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.32.56 (version=TLS1_3 cipher=TLS_CHACHA20_POLY1305_SHA256 bits=256/256); Fri, 14 Aug 2026 18:32:57 -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 0/2] net_shaper: fix kernel-doc rendering Date: Sat, 15 Aug 2026 03:32:27 +0200 Message-Id: X-Mailer: git-send-email 2.39.5 (Apple Git-154) Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit The net_shaper_ops documentation contains a malformed ReST list and exposes a kerneldoc.py title-context bug which drops valid headings. Fix the list first because the parser correction makes it visible. The parser fix also restores three Xe DRM RAS headings already in mainline. Tested with Sphinx 9.1.0: Docutils 0.21.2 and 0.22.4: make SPHINXDIRS=networking htmldocs Docutils 0.22.4: make htmldocs The full output differed only in the intended net_shaper and Xe rendering and checkout-path-dependent build artifacts. Changes from v1: - fix heading parsing instead of replacing headings with bold labels - split the list and parser fixes - add diagnostics and point the Fixes tag at the kerneldoc.py regression v1: https://lore.kernel.org/netdev/20260813192131.21254-1-kmehltretter@gmail.com/ Karl Mehltretter (2): net_shaper: fix kernel-doc list indentation docs: kerneldoc.py: preserve headings in kernel-doc output Documentation/sphinx/kerneldoc.py | 3 ++- include/net/net_shaper.h | 9 +++++---- 2 files changed, 7 insertions(+), 5 deletions(-) base-commit: 3205699d79f262412c1be7fc1c04066610d3cd52 -- 2.53.0