Re: [PATCH v2] iio: fix kernel-doc warnings in industrialio-backend.c
From: Andy Shevchenko
Date: Tue Oct 28 2025 - 05:09:39 EST
On Mon, Oct 27, 2025 at 10:35:02AM -0500, David Lechner wrote:
> On 10/27/25 4:21 AM, KRIISHSHARMA wrote:
...
> > * iio_backend_oversampling_ratio_set - set the oversampling ratio
> > * @back: Backend device
> > + * @chan: Channel number
> > * @ratio: The oversampling ratio - value 1 corresponds to no oversampling.
> > *
> > * Return:
>
> I guess it would not hurt to change this to RETURNS: to match the
> rest of the file either.
Good catch! KRIISHSHARMA, please check the whole file for this as it's not a
direct mistake from kernel-doc perspective, there is a mistake from consistency
point of view and hence needs to be addressed.
...
> > + * RETURNS:
> > + * Pointer to the driver private data associated with the backend.
--
With Best Regards,
Andy Shevchenko