drm: improve the documentation of connector hpd ops
authorAbhinav Kumar <quic_abhinavk@quicinc.com>
Wed, 20 Sep 2023 20:13:58 +0000 (13:13 -0700)
committerDmitry Baryshkov <dmitry.baryshkov@linaro.org>
Sun, 3 Dec 2023 18:17:10 +0000 (20:17 +0200)
commita5b2dcb96d6acb286459612a142371b0d74543bf
tree0da62b4212682df0d5a123cd0bdd974d2e900280
parent5d86c15c3171c3ecebd84d53e30d9812b5591c84
drm: improve the documentation of connector hpd ops

While making the changes in [1], it was noted that the documentation
of the enable_hpd() and disable_hpd() does not make it clear that
these ops should not try to do hpd state maintenance and should only
enable/disable hpd related hardware for the connector.

The state management of these calls to make sure these calls are
balanced is handled by the DRM core and we should keep it that way
to minimize the overhead in the drivers which implement these ops.

[1]: https://patchwork.freedesktop.org/patch/558387/

Signed-off-by: Abhinav Kumar <quic_abhinavk@quicinc.com>
Suggested-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Reviewed-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Signed-off-by: Dmitry Baryshkov <dmitry.baryshkov@linaro.org>
Link: https://patchwork.freedesktop.org/patch/msgid/20230920201358.27597-1-quic_abhinavk@quicinc.com
include/drm/drm_modeset_helper_vtables.h