[PATCH 1/1] drm: bridge: Mark deprecated operations in drm_bridge_funcs

[Sam Ravnborg]

drm_bridge_funcs includes several duplicated operations as atomic
variants has been added over time.
New bridge drivers shall use the atomic variants - mark the deprecated
operations to try to avoid usage in new bridge drivers.

Signed-off-by: Sam Ravnborg <s...@ravnborg.org>
Cc: Laurent Pinchart <laurent.pinch...@ideasonboard.com>
Cc: Andrzej Hajda <a.ha...@samsung.com>
Cc: Maarten Lankhorst <maarten.lankho...@linux.intel.com>
Cc: Maxime Ripard <mrip...@kernel.org>
Cc: Thomas Zimmermann <tzimmerm...@suse.de>
Cc: David Airlie <airl...@linux.ie>
Cc: Daniel Vetter <dan...@ffwll.ch>
---
 include/drm/drm_bridge.h | 28 ++++++++++++++++++++++++++--
 1 file changed, 26 insertions(+), 2 deletions(-)

diff --git a/include/drm/drm_bridge.h b/include/drm/drm_bridge.h
index 2195daa289d2..6805898d70f5 100644
--- a/include/drm/drm_bridge.h
+++ b/include/drm/drm_bridge.h
@@ -171,6 +171,11 @@ struct drm_bridge_funcs {
         * signals) feeding it is still running when this callback is called.
         *
         * The @disable callback is optional.
+        *
+        * NOTE:
+        *
+        * This is deprecated, do not use!
+        * New drivers shall use &drm_bridge_funcs.atomic_disable.
         */
        void (*disable)(struct drm_bridge *bridge);
 
@@ -190,6 +195,11 @@ struct drm_bridge_funcs {
         * called.
         *
         * The @post_disable callback is optional.
+        *
+        * NOTE:
+        *
+        * This is deprecated, do not use!
+        * New drivers shall use &drm_bridge_funcs.atomic_post_disable.
         */
        void (*post_disable)(struct drm_bridge *bridge);
 
@@ -213,11 +223,15 @@ struct drm_bridge_funcs {
         * For atomic drivers the adjusted_mode is the mode stored in
         * &drm_crtc_state.adjusted_mode.
         *
-        * NOTE:
-        *
         * If a need arises to store and access modes adjusted for other
         * locations than the connection between the CRTC and the first bridge,
         * the DRM framework will have to be extended with DRM bridge states.
+        *
+        * NOTE:
+        *
+        * This is deprecated, do not use!
+        * New drivers shall set their mode in &drm_bridge_funcs.atomic_enable
+        * operation.
         */
        void (*mode_set)(struct drm_bridge *bridge,
                         const struct drm_display_mode *mode,
@@ -239,6 +253,11 @@ struct drm_bridge_funcs {
         * there is one) when this callback is called.
         *
         * The @pre_enable callback is optional.
+        *
+        * NOTE:
+        *
+        * This is deprecated, do not use!
+        * New drivers shall use &drm_bridge_funcs.atomic_pre_enable.
         */
        void (*pre_enable)(struct drm_bridge *bridge);
 
@@ -259,6 +278,11 @@ struct drm_bridge_funcs {
         * chain if there is one.
         *
         * The @enable callback is optional.
+        *
+        * NOTE:
+        *
+        * This is deprecated, do not use!
+        * New drivers shall use &drm_bridge_funcs.atomic_enable.
         */
        void (*enable)(struct drm_bridge *bridge);
 
-- 
2.30.2