2023-10-17 02:59:14

by Yang Li

[permalink] [raw]
Subject: [PATCH -next] scsi: pmcraid: Fix some kernel-doc comments

Fix some kernel-doc comments to silence the warnings:
drivers/scsi/pmcraid.c:2697: warning: Excess function parameter 'scsi_cmd' description in 'pmcraid_reset_device'
drivers/scsi/pmcraid.c:2697: warning: Function parameter or member 'scsi_dev' not described in 'pmcraid_reset_device'

Reported-by: Abaci Robot <[email protected]>
Closes: https://bugzilla.openanolis.cn/show_bug.cgi?id=6843
Signed-off-by: Yang Li <[email protected]>
---
drivers/scsi/pmcraid.c | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/drivers/scsi/pmcraid.c b/drivers/scsi/pmcraid.c
index a831b34c08a4..af970cee53c9 100644
--- a/drivers/scsi/pmcraid.c
+++ b/drivers/scsi/pmcraid.c
@@ -2679,7 +2679,7 @@ static int pmcraid_error_handler(struct pmcraid_cmd *cmd)
/**
* pmcraid_reset_device - device reset handler functions
*
- * @scsi_cmd: scsi command struct
+ * @scsi_dev: scsi device struct
* @timeout: command timeout
* @modifier: reset modifier indicating the reset sequence to be performed
*
--
2.20.1.7.g153144c


2023-10-25 02:22:33

by Martin K. Petersen

[permalink] [raw]
Subject: Re: [PATCH -next] scsi: pmcraid: Fix some kernel-doc comments


Yang,

> Fix some kernel-doc comments to silence the warnings:
> drivers/scsi/pmcraid.c:2697: warning: Excess function parameter 'scsi_cmd' description in 'pmcraid_reset_device'
> drivers/scsi/pmcraid.c:2697: warning: Function parameter or member
> 'scsi_dev' not described in 'pmcraid_reset_device'

Applied to 6.7/scsi-staging, thanks!

--
Martin K. Petersen Oracle Linux Engineering

2023-10-30 15:39:42

by Martin K. Petersen

[permalink] [raw]
Subject: Re: [PATCH -next] scsi: pmcraid: Fix some kernel-doc comments

On Tue, 17 Oct 2023 10:58:53 +0800, Yang Li wrote:

> Fix some kernel-doc comments to silence the warnings:
> drivers/scsi/pmcraid.c:2697: warning: Excess function parameter 'scsi_cmd' description in 'pmcraid_reset_device'
> drivers/scsi/pmcraid.c:2697: warning: Function parameter or member 'scsi_dev' not described in 'pmcraid_reset_device'
>
>

Applied to 6.7/scsi-queue, thanks!

[1/1] scsi: pmcraid: Fix some kernel-doc comments
https://git.kernel.org/mkp/scsi/c/9e1c911ecbbc

--
Martin K. Petersen Oracle Linux Engineering