Buidling with W=1 reports:
Warning: drivers/iio/industrialio-backend.c:727 function parameter 'chan'
not described in 'iio_backend_oversampling_ratio_set'

The @chan parameter was added when iio_backend_oversampling_ratio_set() was
updated so the contexts could specify the channel, but the parameter was
never documented. Document @chan to silence this warning.

Fixes: 97e6882ed1a1 ("iio: backend: update iio_backend_oversampling_ratio_set")
Signed-off-by: Sukrut Heroorkar <hsukrut3@gmail.com>
---
 drivers/iio/industrialio-backend.c | 1 +
 1 file changed, 1 insertion(+)

diff --git a/drivers/iio/industrialio-backend.c b/drivers/iio/industrialio-backend.c
index 23760652a046..937f4ef38e1e 100644
--- a/drivers/iio/industrialio-backend.c
+++ b/drivers/iio/industrialio-backend.c
@@ -717,6 +717,7 @@ EXPORT_SYMBOL_NS_GPL(iio_backend_data_size_set, "IIO_BACKEND");
 /**
  * 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:
-- 
2.43.0

On Wed, Oct 29, 2025 at 01:21:16PM +0530, Sukrut Heroorkar wrote:
> Buidling with W=1 reports:
> Warning: drivers/iio/industrialio-backend.c:727 function parameter 'chan'
> not described in 'iio_backend_oversampling_ratio_set'
> 
> The @chan parameter was added when iio_backend_oversampling_ratio_set() was
> updated so the contexts could specify the channel, but the parameter was
> never documented. Document @chan to silence this warning.

There is already more comprehensive patch available:
https://lore.kernel.org/linux-iio/20251028093326.1087660-1-kriish.sharma2006@gmail.com/

-- 
With Best Regards,
Andy Shevchenko

On Wed, Oct 29, 2025 at 1:43 PM Andy Shevchenko
<andriy.shevchenko@intel.com> wrote:
>
> On Wed, Oct 29, 2025 at 01:21:16PM +0530, Sukrut Heroorkar wrote:
> > Buidling with W=1 reports:
> > Warning: drivers/iio/industrialio-backend.c:727 function parameter 'chan'
> > not described in 'iio_backend_oversampling_ratio_set'
> >
> > The @chan parameter was added when iio_backend_oversampling_ratio_set() was
> > updated so the contexts could specify the channel, but the parameter was
> > never documented. Document @chan to silence this warning.
>
> There is already more comprehensive patch available:
> https://lore.kernel.org/linux-iio/20251028093326.1087660-1-kriish.sharma2006@gmail.com/
Thanks for the update, Andy.
Regards,
Sukurt Heroorkar
>
> --
> With Best Regards,
> Andy Shevchenko
>
>