Re: [PATCH] SUNRPC: xdr.h: fix all kernel-doc warnings

[Chuck Lever <chuck.lever@oracle.com>]

On 2/28/26 5:09 PM, Randy Dunlap wrote:
> Correct a function parameter name (s/page/folio/) and add function
> return value sections for multiple functions to eliminate
> kernel-doc warnings:
> 
> Warning: include/linux/sunrpc/xdr.h:298 function parameter 'folio' not
>  described in 'xdr_set_scratch_folio'
> Warning: include/linux/sunrpc/xdr.h:337 No description found for return
>  value of 'xdr_stream_remaining'
> Warning: include/linux/sunrpc/xdr.h:357 No description found for return
>  value of 'xdr_align_size'
> Warning: include/linux/sunrpc/xdr.h:374 No description found for return
>  value of 'xdr_pad_size'
> Warning: include/linux/sunrpc/xdr.h:387 No description found for return
>  value of 'xdr_stream_encode_item_present'
> 
> 
> Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
> ---
> Cc: Trond Myklebust <trondmy@kernel.org>
> Cc: Anna Schumaker <anna@kernel.org>
> Cc: Chuck Lever <chuck.lever@oracle.com>
> Cc: Jeff Layton <jlayton@kernel.org>
> Cc: linux-nfs@vger.kernel.org
> 
>  include/linux/sunrpc/xdr.h |   48 +++++++++++++++++------------------
>  1 file changed, 24 insertions(+), 24 deletions(-)
> 
Reviewed-by: Chuck Lever <chuck.lever@oracle.com>

Randy, did you want me to take this one, or will you send it on to
Linus?


-- 
Chuck Lever