Re: [PATCH v2 2/2] iio: imu: inv_icm42600: fix kernel-doc Return: sections

From: Andy Shevchenko

Date: Tue Oct 13 2026 - 17:01:05 EST


On Tue, Oct 06, 2026 at 10:24:04AM +0530, Arnav Kapoor wrote:
> kernel-doc expects the return value to be described in a "Return:"
> section. inv_icm42600_buffer_update_watermark(), inv_icm42600_setup()
> and inv_icm42600_irq_init() use "Returns ..." in the body instead,
> so scripts/kernel-doc -Wall warns for each of them, e.g.:
>
> Warning: .../inv_icm42600_core.c:511 No description found for
> return value of 'inv_icm42600_setup'
>
> Convert them to "Return:" sections. In the watermark comment, move it
> after the description, so the description is not parsed as part of the
> return value section.

Reviewed-by: Andy Shevchenko <andriy.shevchenko@xxxxxxxxx>


--
With Best Regards,
Andy Shevchenko