From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (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 B4C6330F924 for ; Fri, 20 Feb 2026 21:34:45 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1771623285; cv=none; b=SPr30Ef4aNOQU/p+PcuZLr1KG0HJwi3v27KSEzt6wZKb7cijgLRZJB7oZVbKARkCKP57lKNniyP9clynB5XGr4y1A4l22XD9R8n47Ffm5BpAO5v3clPHCEnvSV1fCrXTW3d0IdfQY03V0D4AyEXrEkvRjIwczwwXlZk/QNev+qo= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1771623285; c=relaxed/simple; bh=Kesq3cbdgsui68+RsTV264hMnJPkd0x8kby+cRdX+cc=; h=Date:To:From:Subject:Message-Id; b=tKg/qt5G39st6jgKMz0nWsXRz+RIdMqSqs2t8TS07ZDEl8a831RMO+fDITIg5/Kl5WF56tqNGMvgdK4muupQrIyfgh3qNoCIsDjYxQJVVr98VruMzROuhr+WxCu5+hr6/kyI2Vxxby2JYeO5lrjenPdf3i5YYbDjzXMCNaWdvwc= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=linux-foundation.org header.i=@linux-foundation.org header.b=Yt86SbTW; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=linux-foundation.org header.i=@linux-foundation.org header.b="Yt86SbTW" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 79E89C116C6; Fri, 20 Feb 2026 21:34:45 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=linux-foundation.org; s=korg; t=1771623285; bh=Kesq3cbdgsui68+RsTV264hMnJPkd0x8kby+cRdX+cc=; h=Date:To:From:Subject:From; b=Yt86SbTWiBCHVCr+UfEnvobYs9HPVXwqUHNVhYDjtT5QQMUFZUrQComM3KbHND/rN rIEM9PjGuvKcxfd+0gYZk4MGK1nZOAcVr7VOPkTCmMRNSiimOF3F4eJqXPk4yC5ZeE CFv2CvXayTMde35xZ2wQiDX4yCsl+L1Vqx/SLU9Y= Date: Fri, 20 Feb 2026 13:34:44 -0800 To: mm-commits@vger.kernel.org,kees@kernel.org,djwong@kernel.org,andriy.shevchenko@intel.com,dmantipov@yandex.ru,akpm@linux-foundation.org From: Andrew Morton Subject: + lib-cmdline-adjust-a-few-comments-to-fix-kernel-doc-wreturn-warnings.patch added to mm-nonmm-unstable branch Message-Id: <20260220213445.79E89C116C6@smtp.kernel.org> Precedence: bulk X-Mailing-List: mm-commits@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: The patch titled Subject: lib/cmdline: adjust a few comments to fix kernel-doc -Wreturn warnings has been added to the -mm mm-nonmm-unstable branch. Its filename is lib-cmdline-adjust-a-few-comments-to-fix-kernel-doc-wreturn-warnings.patch This patch will shortly appear at https://git.kernel.org/pub/scm/linux/kernel/git/akpm/25-new.git/tree/patches/lib-cmdline-adjust-a-few-comments-to-fix-kernel-doc-wreturn-warnings.patch This patch will later appear in the mm-nonmm-unstable branch at git://git.kernel.org/pub/scm/linux/kernel/git/akpm/mm Before you just go and hit "reply", please: a) Consider who else should be cc'ed b) Prefer to cc a suitable mailing list as well c) Ideally: find the original patch on the mailing list and do a reply-to-all to that, adding suitable additional cc's *** Remember to use Documentation/process/submit-checklist.rst when testing your code *** The -mm tree is included into linux-next via various branches at git://git.kernel.org/pub/scm/linux/kernel/git/akpm/mm and is updated there most days ------------------------------------------------------ From: Dmitry Antipov Subject: lib/cmdline: adjust a few comments to fix kernel-doc -Wreturn warnings Date: Thu, 12 Feb 2026 19:44:13 +0300 Fix 'get_option()', 'memparse()' and 'parse_option_str()' comments to match the commonly used style as suggested by kernel-doc -Wreturn. Link: https://lkml.kernel.org/r/20260212164413.889625-6-dmantipov@yandex.ru Signed-off-by: Dmitry Antipov Suggested-by: Andy Shevchenko Reviewed-by: Andy Shevchenko Cc: "Darrick J. Wong" Cc: Kees Cook Signed-off-by: Andrew Morton --- lib/cmdline.c | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) --- a/lib/cmdline.c~lib-cmdline-adjust-a-few-comments-to-fix-kernel-doc-wreturn-warnings +++ a/lib/cmdline.c @@ -43,7 +43,7 @@ static int get_range(char **str, int *pi * When @pint is NULL the function can be used as a validator of * the current option in the string. * - * Return values: + * Return: * 0 - no int in string * 1 - int found, no subsequent comma * 2 - int found including a subsequent comma @@ -145,6 +145,9 @@ EXPORT_SYMBOL(get_options); * * Parses a string into a number. The number stored at @ptr is * potentially suffixed with K, M, G, T, P, E. + * + * Return: The value as recognized by simple_strtoull() multiplied + * by the value as specified by suffix, if any. */ unsigned long long memparse(const char *ptr, char **retptr) @@ -205,7 +208,7 @@ EXPORT_SYMBOL(memparse); * This function parses a string containing a comma-separated list of * strings like a=b,c. * - * Return true if there's such option in the string, or return false. + * Return: True if there's such option in the string or false otherwise. */ bool parse_option_str(const char *str, const char *option) { _ Patches currently in -mm which might be from dmantipov@yandex.ru are lib-fix-_parse_integer_limit-to-handle-overflow.patch lib-fix-memparse-to-handle-overflow.patch lib-add-more-string-to-64-bit-integer-conversion-overflow-tests.patch lib-cmdline_kunit-add-test-case-for-memparse.patch lib-cmdline-adjust-a-few-comments-to-fix-kernel-doc-wreturn-warnings.patch