[PATCH v2 2/2] iio: imu: inv_icm42600: fix kernel-doc Return: sections

[Arnav Kapoor <kapoorarnav43@gmail.com>]

kernel-doc expects the return value to be described in a "Return:"
section. inv_icm42600_buffer_update_watermark(), inv_icm42600_setup()
and inv_icm42600_irq_init() use "Returns ..." in the body instead,
so scripts/kernel-doc -Wall warns for each of them, e.g.:

  Warning: .../inv_icm42600_core.c:511 No description found for
  return value of 'inv_icm42600_setup'

Convert them to "Return:" sections. In the watermark comment, move it
after the description, so the description is not parsed as part of the
return value section.

Assisted-by: LLM
Signed-off-by: Arnav Kapoor <kapoorarnav43@gmail.com>
---
 drivers/iio/imu/inv_icm42600/inv_icm42600_buffer.c | 4 ++--
 drivers/iio/imu/inv_icm42600/inv_icm42600_core.c   | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/drivers/iio/imu/inv_icm42600/inv_icm42600_buffer.c b/drivers/iio/imu/inv_icm42600/inv_icm42600_buffer.c
index 2bf9fc29d7d2..7ecd7257921c 100644
--- a/drivers/iio/imu/inv_icm42600/inv_icm42600_buffer.c
+++ b/drivers/iio/imu/inv_icm42600/inv_icm42600_buffer.c
@@ -172,8 +172,6 @@ static unsigned int inv_icm42600_wm_truncate(unsigned int watermark,
  * inv_icm42600_buffer_update_watermark - update watermark FIFO threshold
  * @st:	driver internal state
  *
- * Returns 0 on success, a negative error code otherwise.
- *
  * FIFO watermark threshold is computed based on the required watermark values
  * set for gyro and accel sensors. Since watermark is all about acceptable data
  * latency, we should need to use the smallest latency value. But it is not as
@@ -188,6 +186,8 @@ static unsigned int inv_icm42600_wm_truncate(unsigned int watermark,
  *    dividing this computed latency by the smallest period, which corresponds
  *    to the FIFO frequency. Beware that this is only true because we are not
  *    using 500Hz frequency which is not a multiple of the others.
+ *
+ * Return: 0 on success, a negative error code otherwise.
  */
 int inv_icm42600_buffer_update_watermark(struct inv_icm42600_state *st)
 {
diff --git a/drivers/iio/imu/inv_icm42600/inv_icm42600_core.c b/drivers/iio/imu/inv_icm42600/inv_icm42600_core.c
index cd2e53416f5b..ccaf8ec468f9 100644
--- a/drivers/iio/imu/inv_icm42600/inv_icm42600_core.c
+++ b/drivers/iio/imu/inv_icm42600/inv_icm42600_core.c
@@ -505,7 +505,7 @@ static int inv_icm42600_set_conf(struct inv_icm42600_state *st,
  *  @st:	driver internal state
  *  @bus_setup:	callback for setting up bus specific registers
  *
- *  Returns 0 on success, a negative error code otherwise.
+ *  Return: 0 on success, a negative error code otherwise.
  */
 static int inv_icm42600_setup(struct inv_icm42600_state *st,
 			      inv_icm42600_bus_setup bus_setup)
@@ -639,7 +639,7 @@ static irqreturn_t inv_icm42600_irq_handler(int irq, void *_data)
  * @irq_type:	irq trigger type
  * @open_drain:	true if irq is open drain, false for push-pull
  *
- * Returns 0 on success, a negative error code otherwise.
+ * Return: 0 on success, a negative error code otherwise.
  */
 static int inv_icm42600_irq_init(struct inv_icm42600_state *st, int irq,
 				 int irq_type, bool open_drain)
-- 
2.53.0