Apparently a recent change in docutils has made checking of section
heading levels (underline style) be more careful.
There are 2 heading underline style errors reported here. Repair them by
changing the underline style from Chapter (using '=') to Section (using
'-') since they are used within a Chapter already (in xe_firmware.rst).
"""
Documentation/gpu/xe/xe_firmware.rst:31: drivers/gpu/drm/xe/xe_guc_pc.c:75:
ERROR: A level 2 section cannot be used here.
Frequency management:
=====================
Established title styles: =/= =
The parent of level 2 sections cannot be reached. The parser is at section
level 2 but the current node has only 0 parent section(s).
One reason may be a high level section used in a directive that parses its
content into a base node not attached to the document
(up to Docutils 0.21, these sections were silently dropped). [docutils]
Documentation/gpu/xe/xe_firmware:31: ../drivers/gpu/drm/xe/xe_guc_pc.c:86:
ERROR: A level 2 section cannot be used here.
Render-C States:
================
Established title styles: =/= =
The parent of level 2 sections cannot be reached. The parser is at section
level 2 but the current node has only 0 parent section(s).
One reason may be a high level section used in a directive that parses its
content into a base node not attached to the document
(up to Docutils 0.21, these sections were silently dropped). [docutils]
"""
Fixes: dd08ebf6c352 ("drm/xe: Introduce a new DRM driver for Intel GPUs")
Signed-off-by: Randy Dunlap <[email protected]>
---
Sorry for the resend. I didn't have .gitconfig present so parts of
this didn't work as intended.
Cc: Matthew Brost <[email protected]>
Cc: Lucas De Marchi <[email protected]>
Cc: Thomas Hellström <[email protected]>
Cc: Rodrigo Vivi <[email protected]>
Cc: [email protected]
Cc: Maarten Lankhorst <[email protected]>
Cc: Maxime Ripard <[email protected]>
Cc: Thomas Zimmermann <[email protected]>
Cc: David Airlie <[email protected]>
Cc: Simona Vetter <[email protected]>
---
drivers/gpu/drm/xe/xe_guc_pc.c | 8 ++++----
1 file changed, 4 insertions(+), 4 deletions(-)
--- linux-next-20251010.orig/drivers/gpu/drm/xe/xe_guc_pc.c
+++ linux-next-20251010/drivers/gpu/drm/xe/xe_guc_pc.c
@@ -74,8 +74,8 @@
* connected power conservation features in the GuC firmware. The firmware
* exposes a programming interface to the host for the control of SLPC.
*
- * Frequency management:
- * =====================
+ * Frequency management
+ * --------------------
*
* Xe driver enables SLPC with all of its defaults features and frequency
* selection, which varies per platform.
@@ -85,8 +85,8 @@
* thus saving power. Base profile is default and ensures balanced performance
* for any workload.
*
- * Render-C States:
- * ================
+ * Render-C States
+ * ---------------
*
* Render-C states is also a GuC PC feature that is now enabled in Xe for
* all platforms.
