Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20;
Message-ID: <46ed999e-f6b5-3087-20a2-5505c7c9845b@infradead.org>
Date:   Wed, 12 Jul 2023 07:43:59 -0700
MIME-Version: 1.0
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101
 Thunderbird/102.12.0
Subject: Re: [PATCH -next] scsi: ufs: core: Fix some kernel-doc comments
Content-Language: en-US
To:     Yang Li <yang.lee@linux.alibaba.com>, jejb@linux.ibm.com
Cc:     martin.petersen@oracle.com, alim.akhtar@samsung.com,
        avri.altman@wdc.com, bvanassche@acm.org,
        linux-scsi@vger.kernel.org, linux-kernel@vger.kernel.org,
        Abaci Robot <abaci@linux.alibaba.com>
References: <20230712075836.15375-1-yang.lee@linux.alibaba.com>
From:   Randy Dunlap <rdunlap@infradead.org>
In-Reply-To: <20230712075836.15375-1-yang.lee@linux.alibaba.com>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 7bit
Precedence: bulk


On 7/12/23 00:58, Yang Li wrote:
> Use colons to separate parameter names from their specific meanings.
> silencethe warnings:
> 
> drivers/ufs/core/ufs-mcq.c:499: warning: Function parameter or member 'hba' not described in 'ufshcd_mcq_sq_cleanup'
> drivers/ufs/core/ufs-mcq.c:499: warning: Function parameter or member 'task_tag' not described in 'ufshcd_mcq_sq_cleanup'
> drivers/ufs/core/ufs-mcq.c:560: warning: Function parameter or member 'utrd' not described in 'ufshcd_mcq_nullify_sqe'
> drivers/ufs/core/ufs-mcq.c:583: warning: Function parameter or member 'hba' not described in 'ufshcd_mcq_sqe_search'
> drivers/ufs/core/ufs-mcq.c:583: warning: Function parameter or member 'hwq' not described in 'ufshcd_mcq_sqe_search'
> drivers/ufs/core/ufs-mcq.c:583: warning: Function parameter or member 'task_tag' not described in 'ufshcd_mcq_sqe_search'
> drivers/ufs/core/ufs-mcq.c:630: warning: Function parameter or member 'cmd' not described in 'ufshcd_mcq_abort'
> 
> Reported-by: Abaci Robot <abaci@linux.alibaba.com>
> Closes: https://bugzilla.openanolis.cn/show_bug.cgi?id=5850
> Signed-off-by: Yang Li <yang.lee@linux.alibaba.com>


Reviewed-by: Randy Dunlap <rdunlap@infradead.org>

Thanks.

> ---
>  drivers/ufs/core/ufs-mcq.c | 14 +++++++-------
>  1 file changed, 7 insertions(+), 7 deletions(-)
> 
> diff --git a/drivers/ufs/core/ufs-mcq.c b/drivers/ufs/core/ufs-mcq.c
> index e8bad5e9518e..1e23ba3e2bdf 100644
> --- a/drivers/ufs/core/ufs-mcq.c
> +++ b/drivers/ufs/core/ufs-mcq.c
> @@ -490,8 +490,8 @@ static int ufshcd_mcq_sq_start(struct ufs_hba *hba, struct ufs_hw_queue *hwq)
>  /**
>   * ufshcd_mcq_sq_cleanup - Clean up submission queue resources
>   * associated with the pending command.
> - * @hba - per adapter instance.
> - * @task_tag - The command's task tag.
> + * @hba: per adapter instance.
> + * @task_tag: The command's task tag.
>   *
>   * Returns 0 for success; error code otherwise.
>   */
> @@ -554,7 +554,7 @@ int ufshcd_mcq_sq_cleanup(struct ufs_hba *hba, int task_tag)
>   * Write the sqe's Command Type to 0xF. The host controller will not
>   * fetch any sqe with Command Type = 0xF.
>   *
> - * @utrd - UTP Transfer Request Descriptor to be nullified.
> + * @utrd: UTP Transfer Request Descriptor to be nullified.
>   */
>  static void ufshcd_mcq_nullify_sqe(struct utp_transfer_req_desc *utrd)
>  {
> @@ -571,9 +571,9 @@ static void ufshcd_mcq_nullify_sqe(struct utp_transfer_req_desc *utrd)
>   * If the command is in the submission queue and not issued to the device yet,
>   * nullify the sqe so the host controller will skip fetching the sqe.
>   *
> - * @hba - per adapter instance.
> - * @hwq - Hardware Queue to be searched.
> - * @task_tag - The command's task tag.
> + * @hba: per adapter instance.
> + * @hwq: Hardware Queue to be searched.
> + * @task_tag: The command's task tag.
>   *
>   * Returns true if the SQE containing the command is present in the SQ
>   * (not fetched by the controller); returns false if the SQE is not in the SQ.
> @@ -622,7 +622,7 @@ static bool ufshcd_mcq_sqe_search(struct ufs_hba *hba,
>  
>  /**
>   * ufshcd_mcq_abort - Abort the command in MCQ.
> - * @cmd - The command to be aborted.
> + * @cmd: The command to be aborted.
>   *
>   * Returns SUCCESS or FAILED error codes
>   */

-- 
~Randy