extcon: Fix kernel doc of property fields to avoid warnings
authorAndy Shevchenko <andriy.shevchenko@linux.intel.com>
Wed, 22 Mar 2023 14:39:52 +0000 (16:39 +0200)
committerGreg Kroah-Hartman <gregkh@linuxfoundation.org>
Wed, 19 Jul 2023 14:21:52 +0000 (16:21 +0200)
[ Upstream commit 7e77e0b7a9f4cdf91cb0950749b40c840ea63efc ]

Kernel documentation has to be synchronized with a code, otherwise
the validator is not happy:

     Function parameter or member 'usb_propval' not described in 'extcon_cable'
     Function parameter or member 'chg_propval' not described in 'extcon_cable'
     Function parameter or member 'jack_propval' not described in 'extcon_cable'
     Function parameter or member 'disp_propval' not described in 'extcon_cable'

Describe the fields added in the past.

Fixes: 067c1652e7a7 ("extcon: Add the support for extcon property according to extcon type")
Signed-off-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com>
Signed-off-by: Chanwoo Choi <cw00.choi@samsung.com>
Signed-off-by: Sasha Levin <sashal@kernel.org>
drivers/extcon/extcon.c

index e1c7135..01fd920 100644 (file)
@@ -206,6 +206,10 @@ static const struct __extcon_info {
  * @attr_name:         "name" sysfs entry
  * @attr_state:                "state" sysfs entry
  * @attrs:             the array pointing to attr_name and attr_state for attr_g
+ * @usb_propval:       the array of USB connector properties
+ * @chg_propval:       the array of charger connector properties
+ * @jack_propval:      the array of jack connector properties
+ * @disp_propval:      the array of display connector properties
  */
 struct extcon_cable {
        struct extcon_dev *edev;