[PATCH v1 02/14] extcon: Fix kernel doc of property capability fields to avoid warnings

Andy Shevchenko posted 14 patches 3 years ago
There is a newer version of this series
[PATCH v1 02/14] extcon: Fix kernel doc of property capability fields to avoid warnings
Posted by Andy Shevchenko 3 years ago
Kernel documentation has to be synchronized with a code, otherwise
the validator is not happy:

     Function parameter or member 'usb_bits' not described in 'extcon_cable'
     Function parameter or member 'chg_bits' not described in 'extcon_cable'
     Function parameter or member 'jack_bits' not described in 'extcon_cable'
     Function parameter or member 'disp_bits' not described in 'extcon_cable'

Describe the fields added in the past.

Fixes: ceaa98f442cf ("extcon: Add the support for the capability of each property")
Signed-off-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com>
---
 drivers/extcon/extcon.c | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/drivers/extcon/extcon.c b/drivers/extcon/extcon.c
index 1bc2639704c2..79006ab5334b 100644
--- a/drivers/extcon/extcon.c
+++ b/drivers/extcon/extcon.c
@@ -210,6 +210,10 @@ static const struct __extcon_info {
  * @chg_propval:	the array of charger connector properties
  * @jack_propval:	the array of jack connector properties
  * @disp_propval:	the array of display connector properties
+ * @usb_bits:		the bit array of the USB connector property capabilities
+ * @chg_bits:		the bit array of the charger connector property capabilities
+ * @jack_bits:		the bit array of the jack connector property capabilities
+ * @disp_bits:		the bit array of the display connector property capabilities
  */
 struct extcon_cable {
 	struct extcon_dev *edev;
-- 
2.40.0.1.gaa8946217a0b
Re: [PATCH v1 02/14] extcon: Fix kernel doc of property capability fields to avoid warnings
Posted by Chanwoo Choi 3 years ago
On 23. 3. 22. 23:39, Andy Shevchenko wrote:
> Kernel documentation has to be synchronized with a code, otherwise
> the validator is not happy:
> 
>      Function parameter or member 'usb_bits' not described in 'extcon_cable'
>      Function parameter or member 'chg_bits' not described in 'extcon_cable'
>      Function parameter or member 'jack_bits' not described in 'extcon_cable'
>      Function parameter or member 'disp_bits' not described in 'extcon_cable'
> 
> Describe the fields added in the past.
> 
> Fixes: ceaa98f442cf ("extcon: Add the support for the capability of each property")
> Signed-off-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com>
> ---
>  drivers/extcon/extcon.c | 4 ++++
>  1 file changed, 4 insertions(+)
> 
> diff --git a/drivers/extcon/extcon.c b/drivers/extcon/extcon.c
> index 1bc2639704c2..79006ab5334b 100644
> --- a/drivers/extcon/extcon.c
> +++ b/drivers/extcon/extcon.c
> @@ -210,6 +210,10 @@ static const struct __extcon_info {
>   * @chg_propval:	the array of charger connector properties
>   * @jack_propval:	the array of jack connector properties
>   * @disp_propval:	the array of display connector properties
> + * @usb_bits:		the bit array of the USB connector property capabilities
> + * @chg_bits:		the bit array of the charger connector property capabilities
> + * @jack_bits:		the bit array of the jack connector property capabilities
> + * @disp_bits:		the bit array of the display connector property capabilities
>   */
>  struct extcon_cable {
>  	struct extcon_dev *edev;

Applied it.

-- 
Best Regards,
Samsung Electronics
Chanwoo Choi