Re: [PATCH 14/30] iio: adc: at91-sama5d2_adc: Struct kerneldoc titles need to start with 'struct '

From: Jonathan Cameron
Date: Sat Jul 18 2020 - 11:49:50 EST


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

> Fixes the following W=1 kernel build warning(s):
>
> drivers/iio/adc/at91-sama5d2_adc.c:360: warning: cannot understand function prototype: 'struct at91_adc_dma '
> drivers/iio/adc/at91-sama5d2_adc.c:379: warning: cannot understand function prototype: 'struct at91_adc_touch '
>
> Cc: Ludovic Desroches <ludovic.desroches@xxxxxxxxxxxxx>
> Cc: Eugen Hristev <eugen.hristev@xxxxxxxxxxxxx>
> Cc: Nicolas Ferre <nicolas.ferre@xxxxxxxxxxxxx>
> Cc: Alexandre Belloni <alexandre.belloni@xxxxxxxxxxx>
> Signed-off-by: Lee Jones <lee.jones@xxxxxxxxxx>
Applied.

Thanks,

Jonathan

> ---
> drivers/iio/adc/at91-sama5d2_adc.c | 4 ++--
> 1 file changed, 2 insertions(+), 2 deletions(-)
>
> diff --git a/drivers/iio/adc/at91-sama5d2_adc.c b/drivers/iio/adc/at91-sama5d2_adc.c
> index 9abbbdcc74200..c7fe749419b28 100644
> --- a/drivers/iio/adc/at91-sama5d2_adc.c
> +++ b/drivers/iio/adc/at91-sama5d2_adc.c
> @@ -347,7 +347,7 @@ struct at91_adc_trigger {
> };
>
> /**
> - * at91_adc_dma - at91-sama5d2 dma information struct
> + * struct at91_adc_dma - at91-sama5d2 dma information struct
> * @dma_chan: the dma channel acquired
> * @rx_buf: dma coherent allocated area
> * @rx_dma_buf: dma handler for the buffer
> @@ -369,7 +369,7 @@ struct at91_adc_dma {
> };
>
> /**
> - * at91_adc_touch - at91-sama5d2 touchscreen information struct
> + * struct at91_adc_touch - at91-sama5d2 touchscreen information struct
> * @sample_period_val: the value for periodic trigger interval
> * @touching: is the pen touching the screen or not
> * @x_pos: temporary placeholder for pressure computation