Re: [PATCH 05/30] iio: adc: twl6030-gpadc: Fix some misdocumentation and formatting issues

From: Jonathan Cameron
Date: Sat Jul 18 2020 - 11:38:54 EST


On Fri, 17 Jul 2020 17:55:13 +0100
Lee Jones <lee.jones@xxxxxxxxxx> wrote:

> Kerneldoc expects attributes/parameters to be in '@*.: ' format.
>
> Fixes the following W=1 kernel build warning(s):
>
> drivers/iio/adc/twl6030-gpadc.c:110: warning: Function parameter or member 'ideal' not described in 'twl6030_gpadc_platform_data'
> drivers/iio/adc/twl6030-gpadc.c:110: warning: Function parameter or member 'channel_to_reg' not described in 'twl6030_gpadc_platform_data'
>
> Cc: Stephen Boyd <swboyd@xxxxxxxxxxxx>
> Cc: Nishant Kamat <nskamat@xxxxxx>
> Cc: Balaji T K <balajitk@xxxxxx>
> Cc: Graeme Gregory <gg@xxxxxxxxxxxxxxx>
> Cc: Girish S Ghongdemath <girishsg@xxxxxx>
> Cc: Ambresh K <ambresh@xxxxxx>
> Cc: Oleksandr Kozaruk <oleksandr.kozaruk@xxxxxx>
> Cc: Mikko Ylinen <mikko.k.ylinen@xxxxxxxxx>
> Signed-off-by: Lee Jones <lee.jones@xxxxxxxxxx>
Applied.

Thanks,

Jonathan

> ---
> drivers/iio/adc/twl6030-gpadc.c | 4 ++--
> 1 file changed, 2 insertions(+), 2 deletions(-)
>
> diff --git a/drivers/iio/adc/twl6030-gpadc.c b/drivers/iio/adc/twl6030-gpadc.c
> index f24148bd15de4..a19a6ce65e390 100644
> --- a/drivers/iio/adc/twl6030-gpadc.c
> +++ b/drivers/iio/adc/twl6030-gpadc.c
> @@ -94,9 +94,9 @@ struct twl6030_gpadc_data;
> * struct twl6030_gpadc_platform_data - platform specific data
> * @nchannels: number of GPADC channels
> * @iio_channels: iio channels
> - * @twl6030_ideal: pointer to calibration parameters
> + * @ideal: pointer to calibration parameters
> * @start_conversion: pointer to ADC start conversion function
> - * @channel_to_reg pointer to ADC function to convert channel to
> + * @channel_to_reg: pointer to ADC function to convert channel to
> * register address for reading conversion result
> * @calibrate: pointer to calibration function
> */