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 DF58A15B971 for ; Thu, 14 May 2026 00:08:46 +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=1778717326; cv=none; b=ITbqFEYuYYn9cK8hWNrQDEXf6ThsJGdvXO2DFObA5TLvw/ygKVG5YAIQ9q3Qxjs7tiD0HZGNDM1R1WLIGjdn1mkSfyQTM3YOzCXbHz62uP2zJG7ZTvis8nAmnunivROKWFCkC47BtUhui/+AZFwC+kZL7AOfP3odve3I2ZN7Qfk= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1778717326; c=relaxed/simple; bh=dihJ+kdlhsST6MTHBEHq4JgME+yudFuroow5pxUBZs0=; h=Date:To:From:Subject:Message-Id; b=Bv2DscUkbB5qkTvCuBnS/x9Rj200VeVeEgzD/mESMJ5H8ToETE0tI1ZMZVoUjah64x2YhaFIiXqhwdDS4jwdDuM+Tes9p6AXgK1PDGbG3v17MV59rPOjR1gM1ZZL2TcuP0uYwUYo0aKazopEat8x3EZtyMjLk/XzEV1M9xenAKk= 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=PcUJ0cDH; 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="PcUJ0cDH" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 96778C19425; Thu, 14 May 2026 00:08:46 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=linux-foundation.org; s=korg; t=1778717326; bh=dihJ+kdlhsST6MTHBEHq4JgME+yudFuroow5pxUBZs0=; h=Date:To:From:Subject:From; b=PcUJ0cDHW4tAkthJOKcvVeyhaJJxcFjjY9GBT5OENhNSTJ6MZcBMb4gUlrrLJJthO RX5/YZNEnzgaNtxKcwl0ANgGJbtpeeyqOOVs3J6MKXgDOAsKkaEGg04K6fQ4Glufgg LMlhcYC/W8+K2ISw/5Dr1qqFbHMEbW2H1EJwT6ew= Date: Wed, 13 May 2026 17:08:45 -0700 To: mm-commits@vger.kernel.org,thecharlesjenkins@gmail.com,palmer@dabbelt.com,lkp@intel.com,ardb@kernel.org,aou@eecs.berkeley.edu,andriy.shevchenko@intel.com,alex@ghiti.fr,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: <20260514000846.96778C19425@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: Wed, 13 May 2026 16:44:04 +0300 Fix 'get_option()', 'memparse()' and 'parse_option_str()' comments to match the commonly used style as suggested by kernel-doc -Wreturn. Link: https://lore.kernel.org/20260513134407.884033-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: Charlie Jenkins Cc: kernel test robot Cc: Palmer Dabbelt 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-free-pagelist-on-error-in-iov_iter_extract_pages.patch 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-add-platform-specific-double-word-shifts-for-riscv32.patch lib-kunit-add-tests-for-__ashldi3-__ashrdi3-and-__lshrdi3.patch riscv-fix-building-compressed-efi-image.patch