Received-SPF: pass (google.com: domain of linux-kernel+bounces-169256-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) client-ip=147.75.80.249;
Subject: Re: [PATCH] ubifs: fix kernel-doc warnings
To: Jeff Johnson <quic_jjohnson@quicinc.com>, Richard Weinberger
	<richard@nod.at>
CC: <linux-mtd@lists.infradead.org>, <linux-kernel@vger.kernel.org>
References: <20240502-ubifs-kdoc-v1-1-59c35a325141@quicinc.com>
From: Zhihao Cheng <chengzhihao1@huawei.com>
Message-ID: <c94ba482-0b3a-e8c0-0990-dcb5507148c6@huawei.com>
Date: Mon, 6 May 2024 10:11:53 +0800
User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:68.0) Gecko/20100101
 Thunderbird/68.5.0
Precedence: bulk
MIME-Version: 1.0
In-Reply-To: <20240502-ubifs-kdoc-v1-1-59c35a325141@quicinc.com>
Content-Type: text/plain; charset="utf-8"; format=flowed
Content-Transfer-Encoding: 8bit

在 2024/5/3 4:16, Jeff Johnson 写道:
> make C=1 reports the following kernel-doc warnings:
> 
> fs/ubifs/compress.c:103: warning: Function parameter or struct member 'c' not described in 'ubifs_compress'
> fs/ubifs/compress.c:155: warning: Function parameter or struct member 'c' not described in 'ubifs_decompress'
> fs/ubifs/find.c:353: warning: Excess function parameter 'data' description in 'scan_for_free_cb'
> fs/ubifs/find.c:353: warning: Function parameter or struct member 'arg' not described in 'scan_for_free_cb'
> fs/ubifs/find.c:594: warning: Excess function parameter 'data' description in 'scan_for_idx_cb'
> fs/ubifs/find.c:594: warning: Function parameter or struct member 'arg' not described in 'scan_for_idx_cb'
> fs/ubifs/find.c:786: warning: Excess function parameter 'data' description in 'scan_dirty_idx_cb'
> fs/ubifs/find.c:786: warning: Function parameter or struct member 'arg' not described in 'scan_dirty_idx_cb'
> fs/ubifs/find.c:86: warning: Excess function parameter 'data' description in 'scan_for_dirty_cb'
> fs/ubifs/find.c:86: warning: Function parameter or struct member 'arg' not described in 'scan_for_dirty_cb'
> fs/ubifs/journal.c:369: warning: expecting prototype for wake_up_reservation(). Prototype was for add_or_start_queue() instead
> fs/ubifs/lprops.c:1018: warning: Excess function parameter 'lst' description in 'scan_check_cb'
> fs/ubifs/lprops.c:1018: warning: Function parameter or struct member 'arg' not described in 'scan_check_cb'
> fs/ubifs/lpt.c:1938: warning: Function parameter or struct member 'ptr' not described in 'lpt_scan_node'
> fs/ubifs/replay.c:60: warning: Function parameter or struct member 'hash' not described in 'replay_entry'
> 
> Fix them.
> 
> Signed-off-by: Jeff Johnson <quic_jjohnson@quicinc.com>
> ---
> Note ubifs still has C=1 warnings from smatch that are not addressed:

Reviewed-by: Zhihao Cheng <chengzhihao1@huawei.com>
> 
[...]
> diff --git a/fs/ubifs/journal.c b/fs/ubifs/journal.c
> index 74aee92433d7..f997a85bcdce 100644
> --- a/fs/ubifs/journal.c
> +++ b/fs/ubifs/journal.c
> @@ -359,7 +359,7 @@ static void wake_up_reservation(struct ubifs_info *c)
>   }
>   
>   /**
> - * wake_up_reservation - add current task in queue or start queuing.
> + * add_or_start_queue - add current task in queue or start queuing.
>    * @c: UBIFS file-system description object
>    *
>    * This function starts queuing if queuing is not started, otherwise adds

This period of code was modified in previous patch 
https://patchwork.ozlabs.org/project/linux-mtd/patch/20240227024204.1080739-1-chengzhihao1@huawei.com/ 
, I'm okay to drop the old patch and apply this one.