Re: [RFC PATCH 3/7] iio:ABI docs: Drop device specific docs for _powerdown for the adf4371

From: Jonathan Cameron <jic23@jic23.retrosnub.co.uk>
To: linux-iio@vger.kernel.org, linux-doc@vger.kernel.org,
	Mauro Carvalho Chehab <mchehab+huawei@kernel.org>,
	Lukas Bulwahn <lukas.bulwahn@gmail.com>
Cc: Jonathan Cameron <Jonathan.Cameron@huawei.com>,
	Alexandru Ardelean <alexandru.ardelean@analog.com>
Subject: Re: [RFC PATCH 3/7] iio:ABI docs: Drop device specific docs for _powerdown for the adf4371
Date: Tue, 27 Apr 2021 18:33:38 +0100	[thread overview]
Message-ID: <20210427183321.656b7625@jic23-huawei> (raw)
In-Reply-To: <20210117153816.696693-4-jic23@kernel.org>

On Sun, 17 Jan 2021 15:38:12 +0000
Jonathan Cameron <jic23@kernel.org> wrote:

> From: Jonathan Cameron <Jonathan.Cameron@huawei.com>
> 
> The interface is standard and the extra info provided on exactly what is
> being powered down is not of interest to most users.  Hence this doesn't
> need it's own documentation and can rely on the docs in sysfs-bus-iio
> 
> Fixes:
> $ scripts/get_abi.pl validate
> Warning: /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_powerdown is defined 2 times:  ./Documentation/ABI/testing/sysfs-bus-iio-frequency-adf4371:36  ./Documentation/ABI/testing/sysfs-bus-iio:588
> 
> Cc: Alexandru Ardelean <alexandru.ardelean@analog.com>
> Reported-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
> Signed-off-by: Jonathan Cameron <Jonathan.Cameron@huawei.com>
I'm guessing I can't make a mistake removing docs :)

Applied to the togreg branch of iio.git and pushed out as testing for the
autobuilders to do nothing with it.

Thanks,

Jonathan

> ---
>  Documentation/ABI/testing/sysfs-bus-iio-frequency-adf4371 | 8 --------
>  1 file changed, 8 deletions(-)
> 
> diff --git a/Documentation/ABI/testing/sysfs-bus-iio-frequency-adf4371 b/Documentation/ABI/testing/sysfs-bus-iio-frequency-adf4371
> index 544548ee794c..457f75903963 100644
> --- a/Documentation/ABI/testing/sysfs-bus-iio-frequency-adf4371
> +++ b/Documentation/ABI/testing/sysfs-bus-iio-frequency-adf4371
> @@ -34,11 +34,3 @@ Description:
>  		  out_altvoltage2_name: RF16x
>  		  out_altvoltage3_name: RF32x
>  
> -What:		/sys/bus/iio/devices/iio:deviceX/out_altvoltageY_powerdown
> -KernelVersion:
> -Contact:	linux-iio@vger.kernel.org
> -Description:
> -		This attribute allows the user to power down the PLL and it's
> -		RFOut buffers.
> -		Writing 1 causes the specified channel to power down.
> -		Clearing returns to normal operation.