iio: accel: adxl345: Add comment to probe
authorLothar Rubusch <l.rubusch@gmail.com>
Mon, 1 Apr 2024 19:49:05 +0000 (19:49 +0000)
committerJonathan Cameron <Jonathan.Cameron@huawei.com>
Sat, 6 Apr 2024 15:18:39 +0000 (16:18 +0100)
Add a comment to the probe() function to describe the passed function
pointer argument in particular.

Signed-off-by: Lothar Rubusch <l.rubusch@gmail.com>
Link: https://lore.kernel.org/r/20240401194906.56810-8-l.rubusch@gmail.com
Signed-off-by: Jonathan Cameron <Jonathan.Cameron@huawei.com>
drivers/iio/accel/adxl345_core.c

index 5d0f3243ec6c94e4370aea7710931d9720f8de49..006ce66c0aa38850acff83b14cec2c43bb76cd21 100644 (file)
@@ -168,6 +168,16 @@ static void adxl345_powerdown(void *regmap)
        regmap_write(regmap, ADXL345_REG_POWER_CTL, ADXL345_POWER_CTL_STANDBY);
 }
 
+/**
+ * adxl345_core_probe() - probe and setup for the adxl345 accelerometer,
+ *                        also covers the adlx375 accelerometer
+ * @dev:       Driver model representation of the device
+ * @regmap:    Regmap instance for the device
+ * @setup:     Setup routine to be executed right before the standard device
+ *             setup
+ *
+ * Return: 0 on success, negative errno on error
+ */
 int adxl345_core_probe(struct device *dev, struct regmap *regmap,
                       int (*setup)(struct device*, struct regmap*))
 {