From: Swaraj Gaikwad Date: Tue, 9 Dec 2025 09:48:36 +0000 (+0000) Subject: drm/xe: Fix documentation heading levels in xe_guc_pc.c X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=c7b83a916d62c4d4447d7edf0bc5e06dc2afbdf8;p=thirdparty%2Fkernel%2Flinux.git drm/xe: Fix documentation heading levels in xe_guc_pc.c Sphinx reports htmldocs warnings: Documentation/gpu/xe/xe_firmware:31: ./drivers/gpu/drm/xe/xe_guc_pc.c:76: ERROR: A level 2 section cannot be used here. Documentation/gpu/xe/xe_firmware:31: ./drivers/gpu/drm/xe/xe_guc_pc.c:87: ERROR: A level 2 section cannot be used here. The xe_guc_pc.c documentation is included inside xe_firmware.rst. The headers in the C file currently use '=' underlines, which conflict with the parent document's section levels. Fix this by demoting "Frequency management" and "Render-C States" headers from '=' to '-' to correctly nest them as subsections. Build environment: Python 3.13.7 Sphinx 8.2.3 docutils 0.22.3 Signed-off-by: Swaraj Gaikwad Link: https://patch.msgid.link/20251209094836.18589-1-swarajgaikwad1925@gmail.com Signed-off-by: Rodrigo Vivi --- diff --git a/drivers/gpu/drm/xe/xe_guc_pc.c b/drivers/gpu/drm/xe/xe_guc_pc.c index e2e6edb851ae..54702a0fd05b 100644 --- a/drivers/gpu/drm/xe/xe_guc_pc.c +++ b/drivers/gpu/drm/xe/xe_guc_pc.c @@ -76,7 +76,7 @@ * exposes a programming interface to the host for the control of SLPC. * * Frequency management: - * ===================== + * --------------------- * * Xe driver enables SLPC with all of its defaults features and frequency * selection, which varies per platform. @@ -87,7 +87,7 @@ * for any workload. * * Render-C States: - * ================ + * ---------------- * * Render-C states is also a GuC PC feature that is now enabled in Xe for * all platforms.