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 0E7163D300A for ; Fri, 3 Apr 2026 17:10:54 +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=1775236255; cv=none; b=RdPSysE0LQ4r9YGGf5SLxvK9VIPKNTqpbavnhpUBHGSR+w7QR2MbGrMlcI7GYgpo7Q2kIiRyXS/ukyrocCeDzfrx2OoibGU1eACOE0SgqHFYNHePLZBjD3139pD3exqS2Dv0W1SxzDsUXqdl6f0bbnO09RallMLY0q1njXeasgk= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1775236255; c=relaxed/simple; bh=l4UOBnNxsLWFgzQAixXZBwpbwOQ0Fh4P+wvtyHly5R4=; h=Date:To:From:Subject:Message-Id; b=cn8SvA7NB3AVogWmD3Gmxc3WP/5mHvPslMQfJuP3VpXXx7DxXb3OpNK9xbGYa6m/PNOJZDZOfg8EsINKA8s9zWU6RHAIBycel2X6+O9GtUeWBOo80DTsFBPgpIucm0EcEruIpLbSPtem+SDivywplofLdlRdU5suGvFI3LVOPME= 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=wB9cFAXq; 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="wB9cFAXq" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 9DC45C4CEF7; Fri, 3 Apr 2026 17:10:54 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=linux-foundation.org; s=korg; t=1775236254; bh=l4UOBnNxsLWFgzQAixXZBwpbwOQ0Fh4P+wvtyHly5R4=; h=Date:To:From:Subject:From; b=wB9cFAXqZa2A3/AexHG0foXdzNoyCKdhb8LitBVb6VPaYiPS6ig4SV0sRljwgk4O1 Vnf7X+kEFe6AVSSIvLHutrmbAqpJ+q/mHshKCWE6X7zcFyr7A/sD38wknzjJ2d8Zoe ChGkPzLBJQHS/yH+74RCgzDABT8Jk1YT7z+3Nl6U= Date: Fri, 03 Apr 2026 10:10:54 -0700 To: mm-commits@vger.kernel.org,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: <20260403171054.9DC45C4CEF7@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: Fri, 3 Apr 2026 13:33:37 +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/20260403103338.1122415-6-dmantipov@yandex.ru Signed-off-by: Dmitry Antipov Suggested-by: Andy Shevchenko Reviewed-by: Andy Shevchenko Cc: Albert Ou Cc: Alexandre Ghiti Cc: Ard Biesheuvel Cc: "Darrick J. Wong" Cc: Kees Cook Cc: Nathan Chancellor Cc: Palmer Dabbelt Cc: Paul Walmsley 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 riscv-export-symbols-needed-for-riscv32-efi-stub.patch