Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

drm: Fix kerneldoc warns in connector-related docs

Fixes the following warnings:
../drivers/gpu/drm/drm_connector.c:989: WARNING: Unexpected indentation.
../drivers/gpu/drm/drm_connector.c:993: WARNING: Unexpected indentation.
../include/drm/drm_connector.h:544: WARNING: Inline interpreted text or phrase reference start-string without end-string.
../include/drm/drm_connector.h:544: WARNING: Inline interpreted text or phrase reference start-string without end-string.

Changes in v2:
- Use () instead of & for functions (Sam)

Fixes: 1b27fbdde1df ("drm: Add drm_atomic_get_(old|new)_connector_for_encoder() helpers")
Fixes: bb5a45d40d50 ("drm/hdcp: update content protection property with uevent")
Cc: Ramalingam C <ramalingam.c@intel.com>
Cc: Daniel Vetter <daniel@ffwll.ch>
Cc: Pekka Paalanen <pekka.paalanen@collabora.com>
Cc: Sam Ravnborg <sam@ravnborg.org>
Cc: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Cc: Jani Nikula <jani.nikula@intel.com>
Cc: Sean Paul <seanpaul@chromium.org>
Cc: Maarten Lankhorst <maarten.lankhorst@linux.intel.com>
Cc: Maxime Ripard <maxime.ripard@bootlin.com>
Cc: Sean Paul <sean@poorly.run>
Cc: David Airlie <airlied@linux.ie>
Cc: dri-devel@lists.freedesktop.org
Reviewed-by: Sam Ravnborg <sam@ravnborg.org>
Signed-off-by: Sean Paul <seanpaul@chromium.org>
Link: https://patchwork.freedesktop.org/patch/msgid/20190812140112.6702-1-sean@poorly.run

+8 -6
+6 -4
drivers/gpu/drm/drm_connector.c
··· 986 986 * - Kernel sends uevent with the connector id and property id through 987 987 * @drm_hdcp_update_content_protection, upon below kernel triggered 988 988 * scenarios: 989 - * DESIRED -> ENABLED (authentication success) 990 - * ENABLED -> DESIRED (termination of authentication) 989 + * 990 + * - DESIRED -> ENABLED (authentication success) 991 + * - ENABLED -> DESIRED (termination of authentication) 991 992 * - Please note no uevents for userspace triggered property state changes, 992 993 * which can't fail such as 993 - * DESIRED/ENABLED -> UNDESIRED 994 - * UNDESIRED -> DESIRED 994 + * 995 + * - DESIRED/ENABLED -> UNDESIRED 996 + * - UNDESIRED -> DESIRED 995 997 * - Userspace is responsible for polling the property or listen to uevents 996 998 * to determine when the value transitions from ENABLED to DESIRED. 997 999 * This signifies the link is no longer protected and userspace should
+2 -2
include/drm/drm_connector.h
··· 543 543 * 544 544 * This is also used in the atomic helpers to map encoders to their 545 545 * current and previous connectors, see 546 - * &drm_atomic_get_old_connector_for_encoder() and 547 - * &drm_atomic_get_new_connector_for_encoder(). 546 + * drm_atomic_get_old_connector_for_encoder() and 547 + * drm_atomic_get_new_connector_for_encoder(). 548 548 * 549 549 * NOTE: Atomic drivers must fill this out (either themselves or through 550 550 * helpers), for otherwise the GETCONNECTOR and GETENCODER IOCTLs will