Re: [PATCH v3 40/56] firmware: stratix10-svc: fix kernel-doc markups

[Richard Gong]

Acked-by: Richard Gong <richard.gong@xxxxxxxxxxxxxxx>

On 10/23/20 11:33 AM, Mauro Carvalho Chehab wrote:
> There are some common comments marked, instead, with kernel-doc
> notation, which won't work.
>
> While here, rename an identifier, in order to match the
> function prototype below kernel-doc markup.
>
> Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@xxxxxxxxxx>
> ---
>   include/linux/firmware/intel/stratix10-svc-client.h | 10 +++++-----
>   1 file changed, 5 insertions(+), 5 deletions(-)
>
> diff --git a/include/linux/firmware/intel/stratix10-svc-client.h b/include/linux/firmware/intel/stratix10-svc-client.h
> index a93d85932eb9..ebc295647581 100644
> --- a/include/linux/firmware/intel/stratix10-svc-client.h
> +++ b/include/linux/firmware/intel/stratix10-svc-client.h
> @@ -6,7 +6,7 @@
>   #ifndef __STRATIX10_SVC_CLIENT_H
>   #define __STRATIX10_SVC_CLIENT_H
>   
> -/**
> +/*
>    * Service layer driver supports client names
>    *
>    * fpga: for FPGA configuration
> @@ -15,7 +15,7 @@
>   #define SVC_CLIENT_FPGA			"fpga"
>   #define SVC_CLIENT_RSU			"rsu"
>   
> -/**
> +/*
>    * Status of the sent command, in bit number
>    *
>    * SVC_STATUS_OK:
> @@ -50,7 +50,7 @@
>   #define SVC_STATUS_ERROR		5
>   #define SVC_STATUS_NO_SUPPORT		6
>   
> -/**
> +/*
>    * Flag bit for COMMAND_RECONFIG
>    *
>    * COMMAND_RECONFIG_FLAG_PARTIAL:
> @@ -58,7 +58,7 @@
>    */
>   #define COMMAND_RECONFIG_FLAG_PARTIAL	1
>   
> -/**
> +/*
>    * Timeout settings for service clients:
>    * timeout value used in Stratix10 FPGA manager driver.
>    * timeout value used in RSU driver
> @@ -218,7 +218,7 @@ void stratix10_svc_free_memory(struct stratix10_svc_chan *chan, void *kaddr);
>   int stratix10_svc_send(struct stratix10_svc_chan *chan, void *msg);
>   
>   /**
> - * intel_svc_done() - complete service request
> + * stratix10_svc_done() - complete service request
>    * @chan: service channel assigned to the client
>    *
>    * This function is used by service client to inform service layer that