Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

accel/qaic: Format DBC states table in sysfs ABI documentation

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

authored by

Bagas Sanjaya and committed by
Jeff Hugo
be4cd2a1 6d61e378

+10 -7
+10 -7
Documentation/ABI/stable/sysfs-driver-qaic
··· 3 3 KernelVersion: 6.19 4 4 Contact: Jeff Hugo <jeff.hugo@oss.qualcomm.com> 5 5 Description: Represents the current state of DMA Bridge channel (DBC). Below are the possible 6 - states, 7 - IDLE (0) - DBC is free and can be activated 8 - ASSIGNED (1) - DBC is activated and a workload is running on device 9 - BEFORE_SHUTDOWN (2) - Sub-system associated with this workload has crashed and 6 + states: 7 + 8 + =================== ========================================================== 9 + IDLE (0) DBC is free and can be activated 10 + ASSIGNED (1) DBC is activated and a workload is running on device 11 + BEFORE_SHUTDOWN (2) Sub-system associated with this workload has crashed and 10 12 it will shutdown soon 11 - AFTER_SHUTDOWN (3) - Sub-system associated with this workload has crashed and 13 + AFTER_SHUTDOWN (3) Sub-system associated with this workload has crashed and 12 14 it has shutdown 13 - BEFORE_POWER_UP (4) - Sub-system associated with this workload is shutdown and 15 + BEFORE_POWER_UP (4) Sub-system associated with this workload is shutdown and 14 16 it will be powered up soon 15 - AFTER_POWER_UP (5) - Sub-system associated with this workload is now powered up 17 + AFTER_POWER_UP (5) Sub-system associated with this workload is now powered up 18 + =================== ========================================================== 16 19 Users: Any userspace application or clients interested in DBC state.