driver core: Add kernel-doc for DEV_FLAG_COUNT enum value

dianders · gregkh · commit 68532b09cbfc · 2026-05-17T17:13:33.000+02:00
commit 5b48431 upstream. Even though nobody should use this value (except when declaring the "flags" bitmap), kernel-doc still gets upset that it's not documented. It reports: WARNING: ../include/linux/device.h:519 Enum value 'DEV_FLAG_COUNT' not described in enum 'struct_device_flags' Add the description of DEV_FLAG_COUNT. Fixes: a2225b6 ("driver core: Don't let a device probe until it's ready") Reported-by: Randy Dunlap <rdunlap@infradead.org> Closes: https://lore.kernel.org/f318cd43-81fd-48b9-abf7-92af85f12f91@infradead.org Signed-off-by: Douglas Anderson <dianders@chromium.org> Tested-by: Randy Dunlap <rdunlap@infradead.org> Reviewed-by: Randy Dunlap <rdunlap@infradead.org> Link: https://patch.msgid.link/20260413195910.1.I23aca74fe2d3636a47df196a80920fecb2643220@changeid Signed-off-by: Danilo Krummrich <dakr@kernel.org> Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
diff --git a/include/linux/device.h b/include/linux/device.h
@@ -610,6 +610,7 @@ struct device_physical_location {
  *
  * @DEV_FLAG_READY_TO_PROBE: If set then device_add() has finished enough
  *		initialization that probe could be called.
+ * @DEV_FLAG_COUNT: Number of defined struct_device_flags.
  */
 enum struct_device_flags {
 	DEV_FLAG_READY_TO_PROBE = 0,

Original file line number	Diff line number	Diff line change
`@@ -610,6 +610,7 @@ struct device_physical_location {`
`610`	`610`	`*`
`611`	`611`	`* @DEV_FLAG_READY_TO_PROBE: If set then device_add() has finished enough`
`612`	`612`	`* initialization that probe could be called.`
	`613`	`+ * @DEV_FLAG_COUNT: Number of defined struct_device_flags.`
`613`	`614`	`*/`
`614`	`615`	`enum struct_device_flags {`
`615`	`616`	`DEV_FLAG_READY_TO_PROBE = 0,`