]> git.ipfire.org Git - thirdparty/kernel/linux.git/commit
driver core: add missing kernel-doc for union members
authorRandy Dunlap <rdunlap@infradead.org>
Tue, 23 Jun 2026 19:00:22 +0000 (12:00 -0700)
committerDanilo Krummrich <dakr@kernel.org>
Sun, 28 Jun 2026 22:59:24 +0000 (00:59 +0200)
commit667d0fb32149f023b8b34a1f6f3d384556eafb5a
treefb3d797a1a3192308aab5a755418339499e9d03c
parentdc59e4fea9d83f03bad6bddf3fa2e52491777482
driver core: add missing kernel-doc for union members

The use of __SYSFS_FUNCTION_ALTERNATIVE() adds an anonymous union (or
struct if CONFIG_CFI=y).*

Describe the additional struct/union members to avoid docs build
warnings.

Warning: include/linux/device.h:117 struct member 'show_const' not described in 'device_attribute'
Warning: include/linux/device.h:117 struct member 'store_const' not described in 'device_attribute'

*: kernel-doc ignores CONFIG_ symbols in source files; it is using the
first definition of __SYSFS_FUNCTION_ALTERNATIVE(), which is struct
instead of union.

Fixes: 434506b86a6c ("driver core: Allow the constification of device attributes")
Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Reviewed-by: Thomas Weißschuh <linux@weissschuh.net>
Link: https://patch.msgid.link/20260623190023.407781-1-rdunlap@infradead.org
Signed-off-by: Danilo Krummrich <dakr@kernel.org>
include/linux/device.h