scsi: ufs: core: Improve documentation in include/ufs/ufshci.h

Make it easier to find the sections in the UFSHCI standard where these
constants come from.

Signed-off-by: Bart Van Assche <bvanassche@acm.org>
Link: https://patch.msgid.link/20251014200118.3390839-4-bvanassche@acm.org
Signed-off-by: Martin K. Petersen <martin.petersen@oracle.com>

diff --git a/include/ufs/ufshci.h b/include/ufs/ufshci.h
index e64b701321010be384175d6fbe1d8893023536e1..ff96056b2ac3cd11e7ea2c0f17fbb95ebdde223b 100644 (file)
--- a/include/ufs/ufshci.h
+++ b/include/ufs/ufshci.h
@@ -83,12 +83,14 @@ enum {
 };
 
 enum {
+       /* Submission Queue (SQ) Configuration Registers */
        REG_SQATTR              = 0x0,
        REG_SQLBA               = 0x4,
        REG_SQUBA               = 0x8,
        REG_SQDAO               = 0xC,
        REG_SQISAO              = 0x10,
 
+       /* Completion Queue (CQ) Configuration Registers */
        REG_CQATTR              = 0x20,
        REG_CQLBA               = 0x24,
        REG_CQUBA               = 0x28,
@@ -96,6 +98,7 @@ enum {
        REG_CQISAO              = 0x30,
 };
 
+/* Operation and Runtime Registers - Submission Queues and Completion Queues */
 enum {
        REG_SQHP                = 0x0,
        REG_SQTP                = 0x4,