* [PATCH -next] 9p: Fix some kernel-doc comments
@ 2022-06-15 1:20 Yang Li
2022-06-15 3:02 ` asmadeus
0 siblings, 1 reply; 2+ messages in thread
From: Yang Li @ 2022-06-15 1:20 UTC (permalink / raw)
To: ericvh
Cc: lucho, asmadeus, linux_oss, v9fs-developer, linux-kernel,
Yang Li, Abaci Robot
Remove warnings found by running scripts/kernel-doc,
which is caused by using 'make W=1'.
fs/9p/fid.c:35: warning: Function parameter or member 'pfid' not described in 'v9fs_fid_add'
fs/9p/fid.c:35: warning: Excess function parameter 'fid' description in 'v9fs_fid_add'
fs/9p/fid.c:80: warning: Function parameter or member 'pfid' not described in 'v9fs_open_fid_add'
fs/9p/fid.c:80: warning: Excess function parameter 'fid' description in 'v9fs_open_fid_add'
Reported-by: Abaci Robot <abaci@linux.alibaba.com>
Signed-off-by: Yang Li <yang.lee@linux.alibaba.com>
---
fs/9p/fid.c | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/fs/9p/fid.c b/fs/9p/fid.c
index 289a85eae2ae..3a0f5963b8bd 100644
--- a/fs/9p/fid.c
+++ b/fs/9p/fid.c
@@ -28,7 +28,7 @@ static inline void __add_fid(struct dentry *dentry, struct p9_fid *fid)
/**
* v9fs_fid_add - add a fid to a dentry
* @dentry: dentry that the fid is being added to
- * @fid: fid to add
+ * @pfid: fid to add
*
*/
void v9fs_fid_add(struct dentry *dentry, struct p9_fid **pfid)
@@ -72,7 +72,7 @@ static struct p9_fid *v9fs_fid_find_inode(struct inode *inode, kuid_t uid)
/**
* v9fs_open_fid_add - add an open fid to an inode
* @inode: inode that the fid is being added to
- * @fid: fid to add
+ * @pfid: fid to add
*
*/
--
2.20.1.7.g153144c
^ permalink raw reply related [flat|nested] 2+ messages in thread
* Re: [PATCH -next] 9p: Fix some kernel-doc comments
2022-06-15 1:20 [PATCH -next] 9p: Fix some kernel-doc comments Yang Li
@ 2022-06-15 3:02 ` asmadeus
0 siblings, 0 replies; 2+ messages in thread
From: asmadeus @ 2022-06-15 3:02 UTC (permalink / raw)
To: Yang Li
Cc: ericvh, lucho, linux_oss, v9fs-developer, linux-kernel, Abaci Robot
Yang Li wrote on Wed, Jun 15, 2022 at 09:20:39AM +0800:
> Remove warnings found by running scripts/kernel-doc,
> which is caused by using 'make W=1'.
ugh, I was told W=1 would become the default for net,
but I guess it isn't question about that yet for fs...
Do you know how to make W=1 the default for part of the subtree?
> fs/9p/fid.c:35: warning: Function parameter or member 'pfid' not described in 'v9fs_fid_add'
> fs/9p/fid.c:35: warning: Excess function parameter 'fid' description in 'v9fs_fid_add'
> fs/9p/fid.c:80: warning: Function parameter or member 'pfid' not described in 'v9fs_open_fid_add'
> fs/9p/fid.c:80: warning: Excess function parameter 'fid' description in 'v9fs_open_fid_add'
>
> Reported-by: Abaci Robot <abaci@linux.alibaba.com>
> Signed-off-by: Yang Li <yang.lee@linux.alibaba.com>
Will apply and add a note that it is NULLed out, thanks.
> ---
> fs/9p/fid.c | 4 ++--
> 1 file changed, 2 insertions(+), 2 deletions(-)
>
> diff --git a/fs/9p/fid.c b/fs/9p/fid.c
> index 289a85eae2ae..3a0f5963b8bd 100644
> --- a/fs/9p/fid.c
> +++ b/fs/9p/fid.c
> @@ -28,7 +28,7 @@ static inline void __add_fid(struct dentry *dentry, struct p9_fid *fid)
> /**
> * v9fs_fid_add - add a fid to a dentry
> * @dentry: dentry that the fid is being added to
> - * @fid: fid to add
> + * @pfid: fid to add
> *
> */
> void v9fs_fid_add(struct dentry *dentry, struct p9_fid **pfid)
> @@ -72,7 +72,7 @@ static struct p9_fid *v9fs_fid_find_inode(struct inode *inode, kuid_t uid)
> /**
> * v9fs_open_fid_add - add an open fid to an inode
> * @inode: inode that the fid is being added to
> - * @fid: fid to add
> + * @pfid: fid to add
> *
> */
>
^ permalink raw reply [flat|nested] 2+ messages in thread
end of thread, other threads:[~2022-06-15 3:03 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2022-06-15 1:20 [PATCH -next] 9p: Fix some kernel-doc comments Yang Li
2022-06-15 3:02 ` asmadeus
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.