diff mbox series

scsi: elx: libefc_sli: use "/*" for non-kernel-doc comment

Message ID 20230117070151.29339-1-rdunlap@infradead.org (mailing list archive)
State Accepted
Commit 2aa0f83edb1c5a341f0aca209b0ecd74672fb3fa
Headers show
Series scsi: elx: libefc_sli: use "/*" for non-kernel-doc comment | expand

Commit Message

Randy Dunlap Jan. 17, 2023, 7:01 a.m. UTC
Don't use "/**" to begin non-kernel-doc comments.
Prevent a kernel-doc warning:

drivers/scsi/elx/libefc_sli/sli4.c:13: warning: cannot understand function prototype: 'struct sli4_asic_entry_t sli4_asic_table[] = '

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: James Smart <james.smart@broadcom.com>
Cc: Ram Vegesna <ram.vegesna@broadcom.com>
Cc: target-devel@vger.kernel.org
Cc: "James E.J. Bottomley" <jejb@linux.ibm.com>
Cc: "Martin K. Petersen" <martin.petersen@oracle.com>
---
 drivers/scsi/elx/libefc_sli/sli4.c |    2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

Comments

Martin K. Petersen Jan. 24, 2023, 1:54 a.m. UTC | #1
Randy,

> Don't use "/**" to begin non-kernel-doc comments.
> Prevent a kernel-doc warning:
>
> drivers/scsi/elx/libefc_sli/sli4.c:13: warning: cannot understand function prototype: 'struct sli4_asic_entry_t sli4_asic_table[] = '

Applied to 6.3/scsi-staging, thanks!
diff mbox series

Patch

diff -- a/drivers/scsi/elx/libefc_sli/sli4.c b/drivers/scsi/elx/libefc_sli/sli4.c
--- a/drivers/scsi/elx/libefc_sli/sli4.c
+++ b/drivers/scsi/elx/libefc_sli/sli4.c
@@ -4,7 +4,7 @@ 
  * “Broadcom” refers to Broadcom Inc. and/or its subsidiaries.
  */
 
-/**
+/*
  * All common (i.e. transport-independent) SLI-4 functions are implemented
  * in this file.
  */