Re: [PATCH -next] btrfs: Fix argument list that the kdoc format and script verified.

From: David Sterba
Date: Mon Jan 03 2022 - 13:27:41 EST


On Mon, Dec 20, 2021 at 03:23:06PM +0800, Yang Li wrote:
> The warnings were found by running scripts/kernel-doc, which is
> caused by using 'make W=1'.
>
> fs/btrfs/extent_io.c:3210: warning: Function parameter or member
> 'bio_ctrl' not described in 'btrfs_bio_add_page'
> fs/btrfs/extent_io.c:3210: warning: Excess function parameter 'bio'
> description in 'btrfs_bio_add_page'
> fs/btrfs/extent_io.c:3210: warning: Excess function parameter
> 'prev_bio_flags' description in 'btrfs_bio_add_page'
> fs/btrfs/space-info.c:1602: warning: Excess function parameter 'root'
> description in 'btrfs_reserve_metadata_bytes'
> fs/btrfs/space-info.c:1602: warning: Function parameter or member
> 'fs_info' not described in 'btrfs_reserve_metadata_bytes'
>
> Reported-by: Abaci Robot <abaci@xxxxxxxxxxxxxxxxx>
> Signed-off-by: Yang Li <yang.lee@xxxxxxxxxxxxxxxxx>

Added to misc-next, thanks. I've added a note why it's fixing only the
parameter warnings.