The main goal behind the kernel-docs is to give a hint where the functions are expected to be called. Renaming iio_trigger_poll_chained() to iio_trigger_poll_nested() came from a Jonathan's suggestion in [1] I am a little bit unsure about moving the kernel-doc of iio_trigger_poll to industrialio-trigger.c My motivation behind it: - having the source code together with the documentation tends to be better for understanding - make it easier to understand the _nested in iio_trigger_poll_nested (the call to handle_nested_irq) [1] https://lore.kernel.org/linux-iio/Y+6QoBLh1k82cJVN@carbian/ -- Kind Regards Mehdi Djait Mehdi Djait (2): iio: Improve the kernel-doc of iio_trigger_poll iio: Rename iio_trigger_poll_chained and add kernel-doc drivers/iio/accel/bma400_core.c | 2 +- drivers/iio/accel/kionix-kx022a.c | 2 +- drivers/iio/accel/mma8452.c | 2 +- drivers/iio/accel/msa311.c | 2 +- drivers/iio/adc/ad7606.c | 2 +- drivers/iio/adc/at91-sama5d2_adc.c | 2 +- drivers/iio/adc/max11410.c | 2 +- .../common/st_sensors/st_sensors_trigger.c | 4 ++-- drivers/iio/gyro/fxas21002c_core.c | 2 +- drivers/iio/gyro/mpu3050-core.c | 2 +- drivers/iio/humidity/hts221_buffer.c | 2 +- drivers/iio/industrialio-trigger.c | 19 +++++++++++++++++-- drivers/iio/light/acpi-als.c | 2 +- drivers/iio/light/rpr0521.c | 2 +- drivers/iio/light/st_uvis25_core.c | 2 +- drivers/iio/light/vcnl4000.c | 2 +- drivers/iio/light/vcnl4035.c | 2 +- drivers/iio/potentiostat/lmp91000.c | 2 +- drivers/iio/pressure/zpa2326.c | 2 +- drivers/iio/proximity/as3935.c | 2 +- drivers/iio/trigger/iio-trig-loop.c | 2 +- include/linux/iio/trigger.h | 8 +------- 22 files changed, 39 insertions(+), 30 deletions(-) -- 2.30.2
