All of lore.kernel.org
 help / color / mirror / Atom feed
* [PATCH] btrfs: zstd: remove extraneous asterix at the head of zstd_reclaim_timer_fn() comment
@ 2022-04-18 12:59 Bagas Sanjaya
  2022-04-18 15:29 ` Josef Bacik
  0 siblings, 1 reply; 4+ messages in thread
From: Bagas Sanjaya @ 2022-04-18 12:59 UTC (permalink / raw)
  To: linux-doc
  Cc: Matthew Wilcox, Bagas Sanjaya, Chris Mason, Josef Bacik,
	David Sterba, Nick Terrell, Schspa Shi, linux-btrfs,
	linux-kernel

kernel test robot reports kernel-doc warning:

>> fs/btrfs/zstd.c:98: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

The comment is for zstd_reclaim_timer_fn(). Since the function is
static, the comment isn't meant for kernel-doc consumption.

Remove the extraneous (second) asterix at the head of function comment.

Link: https://lore.kernel.org/linux-doc/202204151934.CkKcnvuJ-lkp@intel.com/
Fixes: b672526e2ee935 ("btrfs: use non-bh spin_lock in zstd timer callback")
Cc: Chris Mason <clm@fb.com>
Cc: Josef Bacik <josef@toxicpanda.com>
Cc: David Sterba <dsterba@suse.com>
Cc: Nick Terrell <terrelln@fb.com>
Cc: Schspa Shi <schspa@gmail.com>
Cc: linux-btrfs@vger.kernel.org
Cc: linux-kernel@vger.kernel.org
Signed-off-by: Bagas Sanjaya <bagasdotme@gmail.com>
---
 In the previous fix attempt [1], Matthew Wilcox suggested to remove the
 second asterix instead since the function is static and it shouldn't
 have kernel-doc comments.

 [1]: https://lore.kernel.org/linux-doc/YluGmERvtQY9ju7Y@casper.infradead.org/

 This patch is based on btrfs-devel/misc-next tree [2].

 [2]: https://github.com/kdave/btrfs-devel.git

 fs/btrfs/zstd.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/fs/btrfs/zstd.c b/fs/btrfs/zstd.c
index 0fe31a6f6e68f0..ca2102a46faefd 100644
--- a/fs/btrfs/zstd.c
+++ b/fs/btrfs/zstd.c
@@ -94,7 +94,7 @@ static inline struct workspace *list_to_workspace(struct list_head *list)
 void zstd_free_workspace(struct list_head *ws);
 struct list_head *zstd_alloc_workspace(unsigned int level);
 
-/**
+/*
  * Timer callback to free unused workspaces.
  *
  * @t: timer

base-commit: 550a34e972578538fd0826916ae4fc407b62bb68
-- 
An old man doll... just what I always wanted! - Clara


^ permalink raw reply related	[flat|nested] 4+ messages in thread

* Re: [PATCH] btrfs: zstd: remove extraneous asterix at the head of zstd_reclaim_timer_fn() comment
  2022-04-18 12:59 [PATCH] btrfs: zstd: remove extraneous asterix at the head of zstd_reclaim_timer_fn() comment Bagas Sanjaya
@ 2022-04-18 15:29 ` Josef Bacik
  2022-04-19  5:19   ` Bagas Sanjaya
  0 siblings, 1 reply; 4+ messages in thread
From: Josef Bacik @ 2022-04-18 15:29 UTC (permalink / raw)
  To: Bagas Sanjaya
  Cc: linux-doc, Matthew Wilcox, Chris Mason, David Sterba,
	Nick Terrell, Schspa Shi, linux-btrfs, linux-kernel

On Mon, Apr 18, 2022 at 07:59:35PM +0700, Bagas Sanjaya wrote:
> kernel test robot reports kernel-doc warning:
> 
> >> fs/btrfs/zstd.c:98: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
> 
> The comment is for zstd_reclaim_timer_fn(). Since the function is
> static, the comment isn't meant for kernel-doc consumption.
> 
> Remove the extraneous (second) asterix at the head of function comment.
> 
> Link: https://lore.kernel.org/linux-doc/202204151934.CkKcnvuJ-lkp@intel.com/
> Fixes: b672526e2ee935 ("btrfs: use non-bh spin_lock in zstd timer callback")
> Cc: Chris Mason <clm@fb.com>
> Cc: Josef Bacik <josef@toxicpanda.com>
> Cc: David Sterba <dsterba@suse.com>
> Cc: Nick Terrell <terrelln@fb.com>
> Cc: Schspa Shi <schspa@gmail.com>
> Cc: linux-btrfs@vger.kernel.org
> Cc: linux-kernel@vger.kernel.org
> Signed-off-by: Bagas Sanjaya <bagasdotme@gmail.com>

Reviewed-by: Josef Bacik <josef@toxicpanda.com>

Thanks,

Josef

^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: [PATCH] btrfs: zstd: remove extraneous asterix at the head of zstd_reclaim_timer_fn() comment
  2022-04-18 15:29 ` Josef Bacik
@ 2022-04-19  5:19   ` Bagas Sanjaya
  2022-04-19 13:06     ` David Sterba
  0 siblings, 1 reply; 4+ messages in thread
From: Bagas Sanjaya @ 2022-04-19  5:19 UTC (permalink / raw)
  To: Josef Bacik
  Cc: linux-doc, Matthew Wilcox, Chris Mason, David Sterba,
	Nick Terrell, Schspa Shi, linux-btrfs, linux-kernel

On 4/18/22 22:29, Josef Bacik wrote:
> Reviewed-by: Josef Bacik <josef@toxicpanda.com>
> 
> Thanks,
> 
> Josef

Thanks for the review. Should I send v2 with your Reviewed-by
tag?

-- 
An old man doll... just what I always wanted! - Clara

^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: [PATCH] btrfs: zstd: remove extraneous asterix at the head of zstd_reclaim_timer_fn() comment
  2022-04-19  5:19   ` Bagas Sanjaya
@ 2022-04-19 13:06     ` David Sterba
  0 siblings, 0 replies; 4+ messages in thread
From: David Sterba @ 2022-04-19 13:06 UTC (permalink / raw)
  To: Bagas Sanjaya
  Cc: Josef Bacik, linux-doc, Matthew Wilcox, Chris Mason,
	David Sterba, Nick Terrell, Schspa Shi, linux-btrfs,
	linux-kernel

On Tue, Apr 19, 2022 at 12:19:44PM +0700, Bagas Sanjaya wrote:
> On 4/18/22 22:29, Josef Bacik wrote:
> > Reviewed-by: Josef Bacik <josef@toxicpanda.com>
> > 
> > Thanks,
> > 
> > Josef
> 
> Thanks for the review. Should I send v2 with your Reviewed-by
> tag?

No, and please don't send fixes for the kdoc formats, the script does
not have the same preferences as we who actually have to read the code.
The kdoc format is convenient for more thnigs than just generating
public documentation.

^ permalink raw reply	[flat|nested] 4+ messages in thread

end of thread, other threads:[~2022-04-19 13:11 UTC | newest]

Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2022-04-18 12:59 [PATCH] btrfs: zstd: remove extraneous asterix at the head of zstd_reclaim_timer_fn() comment Bagas Sanjaya
2022-04-18 15:29 ` Josef Bacik
2022-04-19  5:19   ` Bagas Sanjaya
2022-04-19 13:06     ` David Sterba

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.