]> git.ipfire.org Git - thirdparty/kernel/linux.git/commitdiff
accel/qaic: Format DBC states table in sysfs ABI documentation
authorBagas Sanjaya <bagasdotme@gmail.com>
Mon, 10 Nov 2025 03:59:53 +0000 (10:59 +0700)
committerJeff Hugo <jeff.hugo@oss.qualcomm.com>
Mon, 10 Nov 2025 21:53:43 +0000 (14:53 -0700)
Stephen Rothwell reports htmldocs warnings when merging drm-misc tree:

Documentation/ABI/stable/sysfs-driver-qaic:1: ERROR: Unexpected indentation. [docutils]
Documentation/ABI/stable/sysfs-driver-qaic:1: WARNING: Block quote ends without a blank line; unexpected unindent. [docutils]
Documentation/ABI/stable/sysfs-driver-qaic:1: WARNING: Definition list ends without a blank line; unexpected unindent. [docutils]

These are caused by DMA Bridge channel (DBC) states list in sysfs ABI
docs. Format it as a table to fix them.

Fixes: f286066ed9df38 ("accel/qaic: Add DMA Bridge Channel(DBC) sysfs and uevents")
Reported-by: Stephen Rothwell <sfr@canb.auug.org.au>
Closes: https://lore.kernel.org/linux-next/20251110135038.29e96051@canb.auug.org.au/
Signed-off-by: Bagas Sanjaya <bagasdotme@gmail.com>
Reviewed-by: Randy Dunlap <rdunlap@infradead.org>
Tested-by: Randy Dunlap <rdunlap@infradead.org>
Reviewed-by: Jeff Hugo <jeff.hugo@oss.qualcomm.com>
Signed-off-by: Jeff Hugo <jeff.hugo@oss.qualcomm.com>
Link: https://patch.msgid.link/20251110035952.25778-4-bagasdotme@gmail.com
Documentation/ABI/stable/sysfs-driver-qaic

index e5876935e62b345bebadcb59822b77627b29317c..c767a93342b3c95f18df232f6b7a938d2f08016d 100644 (file)
@@ -3,14 +3,17 @@ Date:         October 2025
 KernelVersion: 6.19
 Contact:       Jeff Hugo <jeff.hugo@oss.qualcomm.com>
 Description:   Represents the current state of DMA Bridge channel (DBC). Below are the possible
-               states,
-               IDLE (0) -              DBC is free and can be activated
-               ASSIGNED (1) -          DBC is activated and a workload is running on device
-               BEFORE_SHUTDOWN (2) -   Sub-system associated with this workload has crashed and
+               states:
+
+               ===================     ==========================================================
+               IDLE (0)                DBC is free and can be activated
+               ASSIGNED (1)            DBC is activated and a workload is running on device
+               BEFORE_SHUTDOWN (2)     Sub-system associated with this workload has crashed and
                                        it will shutdown soon
-               AFTER_SHUTDOWN (3) -    Sub-system associated with this workload has crashed and
+               AFTER_SHUTDOWN (3)      Sub-system associated with this workload has crashed and
                                        it has shutdown
-               BEFORE_POWER_UP (4) -   Sub-system associated with this workload is shutdown and
+               BEFORE_POWER_UP (4)     Sub-system associated with this workload is shutdown and
                                        it will be powered up soon
-               AFTER_POWER_UP (5) -    Sub-system associated with this workload is now powered up
+               AFTER_POWER_UP (5)      Sub-system associated with this workload is now powered up
+               ===================     ==========================================================
 Users:         Any userspace application or clients interested in DBC state.