Re: [ PATCH ] Documentation: fixed doc-build warnings
From: David Howells
Date: Mon Mar 28 2022 - 08:26:24 EST
kushagra765@xxxxxxxxxxx wrote:
> @@ -256,7 +256,6 @@ struct fscache_cookie *fscache_acquire_cookie(struct fscache_volume *volume,
>
> /**
> * fscache_use_cookie - Request usage of cookie attached to an object
> - * @object: Object description
> * @will_modify: If cache is expected to be modified locally
> *
> * Request usage of the cookie attached to an object. The caller should tell
> @@ -272,7 +271,6 @@ static inline void fscache_use_cookie(struct fscache_cookie *cookie,
>
> /**
> * fscache_unuse_cookie - Cease usage of cookie attached to an object
> - * @object: Object description
> * @aux_data: Updated auxiliary data (or NULL)
> * @object_size: Revised size of the object (or NULL)
> *
Just deleting these lines is the wrong thing to do. They should instead
mention the cookie parameter.
David