driver core: Add kernel-doc for DEV_FLAG_COUNT enum value

dianders · Danilo Krummrich · commit 5b484311507b · 2026-04-14T11:27:27.000+02:00
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>
diff --git a/include/linux/device.h b/include/linux/device.h
@@ -466,6 +466,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
`@@ -466,6 +466,7 @@ struct device_physical_location {`
`466`	`466`	`*`
`467`	`467`	`* @DEV_FLAG_READY_TO_PROBE: If set then device_add() has finished enough`
`468`	`468`	`* initialization that probe could be called.`
	`469`	`+ * @DEV_FLAG_COUNT: Number of defined struct_device_flags.`
`469`	`470`	`*/`
`470`	`471`	`enum struct_device_flags {`
`471`	`472`	`DEV_FLAG_READY_TO_PROBE = 0,`