Re: [PATCH v3 1/6] ACPI: utils: Introduce acpi_dev_uid_match() for matching _UID

From: Andy Shevchenko
Date: Tue Oct 24 2023 - 06:57:57 EST


On Tue, Oct 24, 2023 at 12:28:39PM +0300, Mika Westerberg wrote:
> On Tue, Oct 24, 2023 at 11:50:13AM +0530, Raag Jadav wrote:

...

> > + * Returns:
> > + * - %true if matches.
> > + * - %false otherwise.
>
> Nit: these actually do not get formatted like above so you can just
> write it as
>
> Returns: %true in case UIDs match, %false otherwise.
>
> If it is even needed, I think it is pretty obvious from the function
> name what it returns.

kernel-doc complains if there is no Return: section in the text.

--
With Best Regards,
Andy Shevchenko