From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id EEF1F2AD10; Wed, 4 Mar 2026 00:42:50 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1772584974; cv=none; b=b62C0jv9qYwDruMbKN5ts+rkw5lSemJy+6wx1bY032SlrLUieAMhG0Y4ysZn793Qf/Cvfq27cn0yRpRF2OAiN19ZRSoaW99aoxKpOhJNaIIKNLFn1LwdOo8NaUWn6Cap+dJB/k+jgNCUUaS+0RZJy1eaYslwT8xcsYnNxndhdho= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1772584974; c=relaxed/simple; bh=s1i6zYq9VR0Nt2HWigfY/LuyzHPlwvwiIvAmy1d/qSU=; h=Message-ID:Date:MIME-Version:Subject:To:Cc:References:From: In-Reply-To:Content-Type; b=coxPoQ9+eNt2BsSX0pqrQMyaDzU0sJmTimqCyax3g3ehjbYmuc/q7U917/VjgyC9GbcFhS8h8okAQBTXm+R5miqwr8X/aNY33ToXO4yozYbd/3DRAmNCrfJ4nnxb8wBuHZob2u3TYCRpmjm/hiBrZNRCKTUnnqB+LQp8tAKJ9sA= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=infradead.org; spf=none smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=PPCc8jX9; arc=none smtp.client-ip=198.137.202.133 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=infradead.org Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=infradead.org Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="PPCc8jX9" DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: Content-Type:In-Reply-To:From:References:Cc:To:Subject:MIME-Version:Date: Message-ID:Sender:Reply-To:Content-ID:Content-Description; bh=W54BrIv4OmsJTRbeowZQ9IcWhe4c1hxN6cqu3WGoh2s=; b=PPCc8jX9mbP1bIIfhLkPJBDfIv 6nxgj/Z5vbqAoUrMv33mz6t1IlhdsrazxQLiCUjokEnaYKpCd0/XRX+YR2ksIW7CkLMyYNB006AcE g+mMkpB1SED1ZucNfwYaP17NgrhYXhGazl4OHddJEKVBVlI7dZvsP+/8eVmnAjHvtmB/PUuF9lFKF jgeUdDoYwAJSeksi+IBRwbt+aVa4SaHgrUIuja7CnAapUNLlNxxeqBN4FlOETP5eHvlLCPuJnowdt QNlzF8XfSfHNbKSOeQ9vxFhLiycZcX6xnaX9R3Nd63NtTRJ4JGFw8on7qF8bjSDTzFzeCivas5YzM hilkpE1w==; Received: from [50.53.43.113] (helo=[192.168.254.34]) by bombadil.infradead.org with esmtpsa (Exim 4.98.2 #2 (Red Hat Linux)) id 1vxaK8-0000000GB88-3aiE; Wed, 04 Mar 2026 00:42:48 +0000 Message-ID: Date: Tue, 3 Mar 2026 16:42:48 -0800 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH] SUNRPC: xdr.h: fix all kernel-doc warnings To: Chuck Lever , linux-kernel@vger.kernel.org Cc: Trond Myklebust , Anna Schumaker , Jeff Layton , linux-nfs@vger.kernel.org References: <20260228220922.2982492-1-rdunlap@infradead.org> Content-Language: en-US From: Randy Dunlap In-Reply-To: Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit 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 >> --- >> Cc: Trond Myklebust >> Cc: Anna Schumaker >> Cc: Chuck Lever >> Cc: Jeff Layton >> Cc: linux-nfs@vger.kernel.org >> >> include/linux/sunrpc/xdr.h | 48 +++++++++++++++++------------------ >> 1 file changed, 24 insertions(+), 24 deletions(-) >> > Reviewed-by: Chuck Lever > > 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