RFC IIO ABI documentation duplication fixes
Status from this message: Applied.
Get series with b4
b4 am [email protected]Versions newest first
- v1 RFC Latest7 patches 14 repliesApplied
Patches in v1 Applied
| # | Subject and files | Size | Replies | Applied |
|---|---|---|---|---|
| 1/7 | iio:ABI docs: Fix up duplicate *_calibbias_* documentation for icm42600Documentation/ Documentation/ | +13 | 2 replies | |
| 2/7 | iio:ABI docs: Avoid repitition of triggerX/sampling_frequencyDocumentation/ Documentation/ | +2 | 5 replies | |
| 3/7 | iio:ABI docs: Drop device specific docs for _powerdown for the adf4371Documentation/ | +0 | 1 reply | |
| 4/7 | iio:ABI docs: Fix issue around repeated definition of out_currentY_rawDocumentation/ Documentation/ Documentation/ | +16 | 1 reply | |
| 5/7 | iio:ABI docs: Combine sysfs-bus-iio-humidity-hdc2010/hdc100x into one fileDocumentation/ Documentation/ | +2 | 2 replies | |
| 6/7 | iio:ABI docs: Combine the two instances of docs for sensor_sensitivityDocumentation/ Documentation/ Documentation/ | +14 | 1 reply | |
| 7/7 | iio:ABI docs: Move specific description of out_altvoltageX_frequency to main docs.Documentation/ Documentation/ | +19 | 1 reply |
Reviews trailers per patch
3 of 7 patches have a Reviewed-by or Acked-by.
| Patch | Matt Ranostay | Fabrice Gasnier |
|---|---|---|
| 1/7 | ||
| 2/7 | A-b | |
| 3/7 | ||
| 4/7 | ||
| 5/7 | R-b | |
| 6/7 | R-b | |
| 7/7 |
Trailers given in replies are filled; those carried in the patches from earlier versions are outlined with dashes.
Cover letter [RFC PATCH 0/7] IIO ABI documentation duplication fixes
From: Jonathan Cameron <[email protected]>
The nature of IIO devices is that they are highly varied and occaisonly ABI is used in somewhat of a 'best fit' fashion. This has lead to a situation where we had additional more specific ABI docs for some sysfs parameters in certain drivers. Unfortunately the automated documentation building doesn't work well with this both issuing warnings and building a less than ideal output.
So this series attempts to fix that up, mostly by moving the application specific parts, of properties that are documented in more than one place, into a higher level documentation file, sometimes with a device specific note. In a few cases this the result is a bit non-obvious hence the RFC. Roughly speaking I've put the more 'interesting' cases towards the end of the series.
It's worth noting that a general reorganzation, audit of missing docs etc is needed for the IIO ABI docs, but as that's a big job it may well take sometime to get it done. In the meantime let's deal with these issues. Some of the drivers have complex enough ABI that we should probably have detailed docs for them in addition to Documentation/ABI.
Note I haven't yet touched the remaining case of
Warning: /sys/bus/iio/devices/iio:deviceX/in_count0_preset is defined 2 times: ./Documentation/ABI/testing/sysfs-bus-iio-timer-stm32:100 ./Documentation/ABI/testing/sysfs-bus-iio-lptimer-stm32:0
Warning: /sys/bus/iio/devices/iio:deviceX/in_count_quadrature_mode_available is defined 2 times: ./Documentation/ABI/testing/sysfs-bus-iio-counter-104-quad-8:2 ./Documentation/ABI/testing/sysfs-bus-iio-lptimer-stm32:8
This is mainly because I don't really know enough about these devices to conclude exactly what a fused bit of docs should look like. Also worth noting that those are probably deprecated ABI anyway given the move of counters into their own subsystem.
Jonathan Cameron (7):
iio:ABI docs: Fix up duplicate *_calibbias_* documentation for
icm42600
iio:ABI docs: Avoid repitition of triggerX/sampling_frequency iio:ABI docs: Drop device specific docs for _powerdown for the adf4371 iio:ABI docs: Fix issue around repeated definition of out_currentY_raw iio:ABI docs: Combine sysfs-bus-iio-humidity-hdc2010/hdc100x into one
file
iio:ABI docs: Combine the two instances of docs for sensor_sensitivity iio:ABI docs: Move specific description of out_altvoltageX_frequency
to main docs.
Documentation/ABI/testing/sysfs-bus-iio | 45 +++++++++++++++++++
.../ABI/testing/sysfs-bus-iio-distance-srf08 | 8 ----
.../testing/sysfs-bus-iio-frequency-adf4371 | 33 --------------
.../ABI/testing/sysfs-bus-iio-health-afe440x | 10 +----
...umidity-hdc2010 => sysfs-bus-iio-humidity} | 3 +-
.../testing/sysfs-bus-iio-humidity-hdc100x | 9 ----
.../ABI/testing/sysfs-bus-iio-icm42600 | 20 ---------
.../testing/sysfs-bus-iio-light-lm3533-als | 11 ++---
.../ABI/testing/sysfs-bus-iio-proximity | 14 ++++++
.../testing/sysfs-bus-iio-proximity-as3935 | 9 ----
.../ABI/testing/sysfs-bus-iio-timer-stm32 | 8 ----
11 files changed, 66 insertions(+), 104 deletions(-)
rename Documentation/ABI/testing/{sysfs-bus-iio-humidity-hdc2010 => sysfs-bus-iio-humidity} (79%)
delete mode 100644 Documentation/ABI/testing/sysfs-bus-iio-humidity-hdc100x
delete mode 100644 Documentation/ABI/testing/sysfs-bus-iio-icm42600Signature · 1 line
2.30.0