2022-03-01 09:44:27

by Yang Li

Subject: [PATCH -next] ext4: Fix ext4_mb_clear_bb() kernel-doc comment

Remove the excess description of @bh in ext4_mb_clear_bb() kernel-doc
comment to remove warnings found by running scripts/kernel-doc, which
is caused by using 'make W=1'.

fs/ext4/mballoc.c:5895: warning: Excess function parameter 'bh'
description in 'ext4_mb_clear_bb'

Reported-by: Abaci Robot <[email protected]>
Signed-off-by: Yang Li <[email protected]>
---
fs/ext4/mballoc.c | 1 -
1 file changed, 1 deletion(-)

diff --git a/fs/ext4/mballoc.c b/fs/ext4/mballoc.c
index 5f0bc6d0aabe..3546fa27d003 100644
--- a/fs/ext4/mballoc.c
+++ b/fs/ext4/mballoc.c
@@ -5884,7 +5884,6 @@ static void ext4_free_blocks_simple(struct inode *inode, ext4_fsblk_t block,
* Used by ext4_free_blocks()
* @handle: handle for this transaction
* @inode: inode
- * @bh: optional buffer of the block to be freed
* @block: starting physical block to be freed
* @count: number of blocks to be freed
* @flags: flags used by ext4_free_blocks
--
2.20.1.7.g153144c

2022-03-03 17:49:10

by Theodore Ts'o

Subject: Re: [PATCH -next] ext4: Fix ext4_mb_clear_bb() kernel-doc comment

On Tue, 1 Mar 2022 17:21:36 +0800, Yang Li wrote:
> Remove the excess description of @bh in ext4_mb_clear_bb() kernel-doc
> comment to remove warnings found by running scripts/kernel-doc, which
> is caused by using 'make W=1'.
>
> fs/ext4/mballoc.c:5895: warning: Excess function parameter 'bh'
> description in 'ext4_mb_clear_bb'
>
> [...]

Applied, thanks!

[1/1] ext4: Fix ext4_mb_clear_bb() kernel-doc comment
commit: fd9b6fad667c7516a130cf0f3caddcb965710c12

Best regards,
--
Theodore Ts'o <[email protected]>