On Sat, 23 Aug 2025, Javier Garcia <rampx...@gmail.com> wrote:
> - Add needed "@" to avoid warn messages about duplicated symbols
> as there is function and struct with the same name.
> - The fixed warning is:
>
> ./Documentation/gpu/drm-kms:476:
> ./drivers/gpu/drm/drm_modeset_lock.c:377: WARNING: Duplicate C declaration,
> also defined at gpu/drm-kms:48.
> Declaration is '.. c:function:: int drm_modeset_lock (struct
> drm_modeset_lock *lock, struct drm_modeset_acquire_ctx *ctx)'.
> [duplicate_declaration.c]
Please look into why adding @ here appear to fix the issue.
The problem is deeper than what this patch makes it seem, and this
papers over the issue in a way that sets the wrong example for the
future.
BR,
Jani.
>
> Fixes: f3a808817fdb ("drm: fix drm_modeset_lock.h kernel-doc notation")
> Signed-off-by: Javier Garcia <rampx...@gmail.com>
> ---
> include/drm/drm_modeset_lock.h | 2 +-
> 1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/include/drm/drm_modeset_lock.h b/include/drm/drm_modeset_lock.h
> index ec4f543c3d95..0de7046dc653 100644
> --- a/include/drm/drm_modeset_lock.h
> +++ b/include/drm/drm_modeset_lock.h
> @@ -75,7 +75,7 @@ struct drm_modeset_acquire_ctx {
> };
>
> /**
> - * struct drm_modeset_lock - used for locking modeset resources.
> + * @struct drm_modeset_lock - used for locking modeset resources.
> * @mutex: resource locking
> * @head: used to hold its place on &drm_atomi_state.locked list when
> * part of an atomic update
--
Jani Nikula, Intel
