Re: [PATCH v2] string: Add missing kernel-doc return descriptions

From: Andy Shevchenko

Date: Tue Nov 18 2025 - 14:01:37 EST


On Tue, Nov 18, 2025 at 8:50 PM Kriish Sharma
<kriish.sharma2006@xxxxxxxxx> wrote:
>
> While running kernel-doc validation on linux-next, warnings were emitted
> for functions in include/linux/string.h due to missing return value
> documentation:
>
> Warning: include/linux/string.h:375 No description found for return value of 'kbasename'
> Warning: include/linux/string.h:560 No description found for return value of 'strstarts'
>
> This patch adds the missing return value descriptions for both functions
> and clears the related kernel-doc warnings.

Reviewed-by: Andy Shevchenko <andy@xxxxxxxxxx>

...

> * kbasename - return the last part of a pathname.
> *

This blank line can be removed, while at it, but I leave it to you and
maintainers.

> * @path: path to extract the filename from.

--
With Best Regards,
Andy Shevchenko