[PATCH] drm/connector: repair kernel-doc descriptions

From: Randy Dunlap

Date: Fri Sep 18 2026 - 19:42:42 EST


Fix all kernel-doc warnings:

WARNING: ../include/drm/drm_connector.h:292 struct member 'cnmvrr' not described in 'drm_hdmi_vrr_cap'
WARNING: ../include/drm/drm_connector.h:292 struct member 'cinema_vrr' not described in 'drm_hdmi_vrr_cap'
WARNING: ../include/drm/drm_connector.h:292 Excess struct member 'mcnmvrr' description in 'drm_hdmi_vrr_cap' (did you mean one of: 'cnmvrr', 'cinema_vrr')
WARNING: ../include/drm/drm_connector.h:292 Excess struct member 'mcinema_vrr' description in 'drm_hdmi_vrr_cap' (did you mean one of: 'cinema_vrr', 'cnmvrr')
Warning: include/drm/drm_connector.h:2658 No description found for return value of 'drm_connector_lookup'

Signed-off-by: Randy Dunlap <rdunlap@xxxxxxxxxxxxx>
---
Cc: David Airlie <airlied@xxxxxxxxx>
Cc: Simona Vetter <simona@xxxxxxxx>
Cc: Maarten Lankhorst <maarten.lankhorst@xxxxxxxxxxxxxxx>
Cc: Maxime Ripard <mripard@xxxxxxxxxx>
Cc: Thomas Zimmermann <tzimmermann@xxxxxxx>
Cc: dri-devel@xxxxxxxxxxxxxxxxxxxxx

include/drm/drm_connector.h | 6 ++++--
1 file changed, 4 insertions(+), 2 deletions(-)

--- linux-next-20260918.orig/include/drm/drm_connector.h
+++ linux-next-20260918/include/drm/drm_connector.h
@@ -264,10 +264,10 @@ struct drm_hdmi_vrr_cap {
/** @fva: flag for Fast VActive (Quick Frame Transport) support */
bool fva;

- /** @mcnmvrr: flag for Negative M VRR support */
+ /** @cnmvrr: flag for Negative M VRR support */
bool cnmvrr;

- /** @mcinema_vrr: flag for Cinema VRR support */
+ /** @cinema_vrr: flag for Cinema VRR support */
bool cinema_vrr;

/** @mdelta: flag for limited frame-to-frame compensation support */
@@ -2652,6 +2652,8 @@ static inline u32 drm_connector_mask(con
*
* This function looks up the connector object specified by id
* add takes a reference to it.
+ *
+ * Returns: drm connector object if found or %NULL if not found
*/
static inline struct drm_connector *drm_connector_lookup(struct drm_device *dev,
struct drm_file *file_priv,