]> git.ipfire.org Git - thirdparty/kernel/linux.git/commitdiff
driver core: Add kernel-doc for DEV_FLAG_COUNT enum value
authorDouglas Anderson <dianders@chromium.org>
Tue, 14 Apr 2026 02:59:11 +0000 (19:59 -0700)
committerDanilo Krummrich <dakr@kernel.org>
Tue, 14 Apr 2026 09:27:27 +0000 (11:27 +0200)
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: a2225b6e834a ("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>
include/linux/device.h

index f27ed6eb87a954afa48e7766d26180a9f91386e6..ac972e7bead46463fbc87a15cf9f88deb3a955ff 100644 (file)
@@ -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,