2023-07-31 12:10:58

by wangzhu

Subject: [PATCH -next] exportfs: remove kernel-doc warnings in exportfs

Remove kernel-doc warning in exportfs:

fs/exportfs/expfs.c:395: warning: Function parameter or member 'parent'
not described in 'exportfs_encode_inode_fh'

Signed-off-by: Zhu Wang <[email protected]>
---
fs/exportfs/expfs.c | 1 +
1 file changed, 1 insertion(+)

diff --git a/fs/exportfs/expfs.c b/fs/exportfs/expfs.c
index 40e624cf7e92..5074e29f087c 100644
--- a/fs/exportfs/expfs.c
+++ b/fs/exportfs/expfs.c
@@ -386,6 +386,7 @@ static int export_encode_fh(struct inode *inode, struct fid *fid,
* @inode: the object to encode
* @fid: where to store the file handle fragment
* @max_len: maximum length to store there
+ * @parent: parent directory inode, if wanted
* @flags: properties of the requested file handle
*
* Returns an enum fid_type or a negative errno.
--
2.17.1

2023-07-31 13:54:13

by Chuck Lever III

Subject: Re: [PATCH -next] exportfs: remove kernel-doc warnings in exportfs

> On Jul 31, 2023, at 7:23 AM, Zhu Wang <[email protected]> wrote:
>
> Remove kernel-doc warning in exportfs:
>
> fs/exportfs/expfs.c:395: warning: Function parameter or member 'parent'
> not described in 'exportfs_encode_inode_fh'
>
> Signed-off-by: Zhu Wang <[email protected]>
> ---
> fs/exportfs/expfs.c | 1 +
> 1 file changed, 1 insertion(+)
>
> diff --git a/fs/exportfs/expfs.c b/fs/exportfs/expfs.c
> index 40e624cf7e92..5074e29f087c 100644
> --- a/fs/exportfs/expfs.c
> +++ b/fs/exportfs/expfs.c
> @@ -386,6 +386,7 @@ static int export_encode_fh(struct inode *inode, struct fid *fid,
> * @inode: the object to encode
> * @fid: where to store the file handle fragment
> * @max_len: maximum length to store there
> + * @parent: parent directory inode, if wanted
> * @flags: properties of the requested file handle
> *
> * Returns an enum fid_type or a negative errno.
> --
> 2.17.1
>

Applied to nfsd-next. Thanks!


--
Chuck Lever