[PATCH] drm: drm/drm_modeset_lock.h: add a kernel-doc entry

Randy Dunlap rdunlap at infradead.org
Sun Dec 19 17:37:36 UTC 2021


Add @stack_depot to the kernel-doc comments to prevent a kernel-doc
build warning.

../include/drm/drm_modeset_lock.h:74: warning: Function parameter or member 'stack_depot' not described in 'drm_modeset_acquire_ctx'

Signed-off-by: Randy Dunlap <rdunlap at infradead.org>
Cc: David Airlie <airlied at linux.ie>
Cc: Daniel Vetter <daniel at ffwll.ch>
---
 include/drm/drm_modeset_lock.h |    1 +
 1 file changed, 1 insertion(+)

--- linux-next-20211217.orig/include/drm/drm_modeset_lock.h
+++ linux-next-20211217/include/drm/drm_modeset_lock.h
@@ -34,6 +34,7 @@ struct drm_modeset_lock;
  * struct drm_modeset_acquire_ctx - locking context (see ww_acquire_ctx)
  * @ww_ctx: base acquire ctx
  * @contended: used internally for -EDEADLK handling
+ * @stack_depot: used for debugging contended locks & backoff
  * @locked: list of held locks
  * @trylock_only: trylock mode used in atomic contexts/panic notifiers
  * @interruptible: whether interruptible locking should be used.


More information about the dri-devel mailing list