Re: [PATCH] device property: add missing kernel-doc for property_entry

[Andy Shevchenko]

On Sun, Jul 19, 2026 at 03:36:40PM -0700, Randy Dunlap wrote:
> Add kernel-doc for the missing fields in union value:
> 
> Warning: include/linux/property.h:406 struct member 'u8_data' not
>  described in 'property_entry'
> Warning: include/linux/property.h:406 struct member 'u16_data' not
>  described in 'property_entry'
> Warning: include/linux/property.h:406 struct member 'u32_data' not
>  described in 'property_entry'
> Warning: include/linux/property.h:406 struct member 'u64_data' not
>  described in 'property_entry'
> Warning: include/linux/property.h:406 struct member 'str' not described
>  in 'property_entry'

...

>   * @pointer: Pointer to the property when it is not stored inline.
>   * @value: Value of the property when it is stored inline.

> + * @u8_data: @value as an array of u8 numbers
> + * @u16_data: @value as an array of u16 numbers
> + * @u32_data: @value as an array of u32 numbers
> + * @u64_data: @value as an array of u64 numbers
> + * @str: @value as an array of char pointers

I think the proper fix is to add

	/* private: internal representation of @value */

>   */

-- 
With Best Regards,
Andy Shevchenko