Received-SPF: pass (google.com: domain of linux-kernel+bounces-11568-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) client-ip=2604:1380:4601:e00::3;
Date: Tue, 26 Dec 2023 16:03:11 +0000
From: Jonathan Cameron <jic23@kernel.org>
To: Randy Dunlap <rdunlap@infradead.org>
Cc: linux-kernel@vger.kernel.org, Lars-Peter Clausen <lars@metafoo.de>,
 linux-iio@vger.kernel.org
Subject: Re: [PATCH] iio: linux/iio.h: fix Excess kernel-doc description
 warning
Message-ID: <20231226160311.3db9ff73@jic23-huawei>
In-Reply-To: <20231223050556.13948-1-rdunlap@infradead.org>
References: <20231223050556.13948-1-rdunlap@infradead.org>
Precedence: bulk
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit

On Fri, 22 Dec 2023 21:05:56 -0800
Randy Dunlap <rdunlap@infradead.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@infradead.org>
> Cc: Jonathan Cameron <jic23@kernel.org>
> Cc: Lars-Peter Clausen <lars@metafoo.de>
> Cc: linux-iio@vger.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