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

scsi: core: Fix kernel doc for scsi_track_queue_full()

Sphinx reports indentation warning on scsi_track_queue_full() return
values:

Documentation/driver-api/scsi:101: ./drivers/scsi/scsi.c:247: ERROR: Unexpected indentation. [docutils]

Fix the warning by making the return values listing a bullet list.

Fixes: eb44820c28bc ("[SCSI] Add Documentation and integrate into docbook build")
Fixes: 1da177e4c3f4 ("Linux-2.6.12-rc2")
Signed-off-by: Bagas Sanjaya <bagasdotme@gmail.com>
Link: https://lore.kernel.org/r/20250702035822.18072-2-bagasdotme@gmail.com
Signed-off-by: Martin K. Petersen <martin.petersen@oracle.com>

authored by

Bagas Sanjaya and committed by
Martin K. Petersen
6070bd55 023a293b

+5 -3
+5 -3
drivers/scsi/scsi.c
··· 242 242 * specific SCSI device to determine if and when there is a 243 243 * need to adjust the queue depth on the device. 244 244 * 245 - * Returns: 0 - No change needed, >0 - Adjust queue depth to this new depth, 246 - * -1 - Drop back to untagged operation using host->cmd_per_lun 247 - * as the untagged command depth 245 + * Returns: 246 + * * 0 - No change needed 247 + * * >0 - Adjust queue depth to this new depth, 248 + * * -1 - Drop back to untagged operation using host->cmd_per_lun as the 249 + * untagged command depth 248 250 * 249 251 * Lock Status: None held on entry 250 252 *