linux-kernel - Re: [PATCH] iio: linux/iio.h: fix Excess kernel-doc description warning

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [day] [month] [year] [list]

Message-ID: <20231226160311.3db9ff73@jic23-huawei>
Date: Tue, 26 Dec 2023 16:03:11 +0000
From: Jonathan Cameron <jic23@...nel.org>
To: Randy Dunlap <rdunlap@...radead.org>
Cc: linux-kernel@...r.kernel.org, Lars-Peter Clausen <lars@...afoo.de>,
 linux-iio@...r.kernel.org
Subject: Re: [PATCH] iio: linux/iio.h: fix Excess kernel-doc description
 warning

On Fri, 22 Dec 2023 21:05:56 -0800
Randy Dunlap <rdunlap@...radead.org> wrote:

> Remove the @of_xlate: lines to prevent the kernel-doc warning:
> 
> include/linux/iio/iio.h:534: warning: Excess struct member 'of_xlate' description in 'iio_info'
> 
> Signed-off-by: Randy Dunlap <rdunlap@...radead.org>
> Cc: Jonathan Cameron <jic23@...nel.org>
> Cc: Lars-Peter Clausen <lars@...afoo.de>
> Cc: linux-iio@...r.kernel.org
Applied.

Thanks,

Jonathan

> ---
>  include/linux/iio/iio.h |    6 ------
>  1 file changed, 6 deletions(-)
> 
> diff -- a/include/linux/iio/iio.h b/include/linux/iio/iio.h
> --- a/include/linux/iio/iio.h
> +++ b/include/linux/iio/iio.h
> @@ -434,13 +434,7 @@ struct iio_trigger; /* forward declarati
>   * @update_scan_mode:	function to configure device and scan buffer when
>   *			channels have changed
>   * @debugfs_reg_access:	function to read or write register value of device
> - * @of_xlate:		function pointer to obtain channel specifier index.
> - *			When #iio-cells is greater than '0', the driver could
> - *			provide a custom of_xlate function that reads the
> - *			*args* and returns the appropriate index in registered
> - *			IIO channels array.
>   * @fwnode_xlate:	fwnode based function pointer to obtain channel specifier index.
> - *			Functionally the same as @of_xlate.
>   * @hwfifo_set_watermark: function pointer to set the current hardware
>   *			fifo watermark level; see hwfifo_* entries in
>   *			Documentation/ABI/testing/sysfs-bus-iio for details on