Re: [PATCH] SUNRPC: xdr.h: fix all kernel-doc warnings
From: Randy Dunlap
Date: Tue Mar 03 2026 - 19:42:58 EST
On 3/3/26 8:37 AM, Chuck Lever wrote:
> 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@xxxxxxxxxxxxx>
>> ---
>> Cc: Trond Myklebust <trondmy@xxxxxxxxxx>
>> Cc: Anna Schumaker <anna@xxxxxxxxxx>
>> Cc: Chuck Lever <chuck.lever@xxxxxxxxxx>
>> Cc: Jeff Layton <jlayton@xxxxxxxxxx>
>> Cc: linux-nfs@xxxxxxxxxxxxxxx
>>
>> include/linux/sunrpc/xdr.h | 48 +++++++++++++++++------------------
>> 1 file changed, 24 insertions(+), 24 deletions(-)
>>
> Reviewed-by: Chuck Lever <chuck.lever@xxxxxxxxxx>
>
> Randy, did you want me to take this one, or will you send it on to
> Linus?
Please take it. I don't have a direct route to Linus. :)
--
~Randy