Staging: iio: Add kernel-doc for struct hmc5843
authorCristina Opriceana <cristina.opriceana@gmail.com>
Fri, 20 Mar 2015 16:09:43 +0000 (18:09 +0200)
committerGreg Kroah-Hartman <gregkh@linuxfoundation.org>
Mon, 23 Mar 2015 21:20:13 +0000 (22:20 +0100)
This patch documents the struct hmc5843 specific data following
this warning:
"CHECK: struct mutex definition without comment".

Signed-off-by: Cristina Opriceana <cristina.opriceana@gmail.com>
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
drivers/staging/iio/magnetometer/hmc5843.h

index 332a75c3a4fb6423ddb93acced54100070781b79..f3d0da2fe4589c29c9ff318cb64555f05ab46e1a 100644 (file)
@@ -31,12 +31,20 @@ enum hmc5843_ids {
        HMC5983_ID,
 };
 
+/**
+ * struct hcm5843_data - device specific data
+ * @dev:               actual device
+ * @lock:              update and read regmap data
+ * @regmap:            hardware access register maps
+ * @variant:           describe chip variants
+ * @buffer:            3x 16-bit channels + padding + 64-bit timestamp
+ **/
 struct hmc5843_data {
        struct device *dev;
        struct mutex lock;
        struct regmap *regmap;
        const struct hmc5843_chip_info *variant;
-       __be16 buffer[8]; /* 3x 16-bit channels + padding + 64-bit timestamp */
+       __be16 buffer[8];
 };
 
 int hmc5843_common_probe(struct device *dev, struct regmap *regmap,