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

Randy Dunlap posted 1 patch 2 years, 8 months ago
drivers/scsi/elx/libefc_sli/sli4.c |    2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
[PATCH] scsi: elx: libefc_sli: use "/*" for non-kernel-doc comment
Posted by Randy Dunlap 2 years, 8 months ago
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(-)

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.
  */
Re: [PATCH] scsi: elx: libefc_sli: use "/*" for non-kernel-doc comment
Posted by Martin K. Petersen 2 years, 7 months ago
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!

-- 
Martin K. Petersen	Oracle Linux Engineering