[PATCH v3] drm: Improve the output_poll_changed description

From: ZhiJie.Zhang
Date: Sun Jan 17 2021 - 20:23:57 EST


From: zhangzhijie <zhangzhijie@xxxxxxxxxxx>

this callback was used by drm_kms_helper_hotplug_event()

V2: (Thanks for Daniel's suggestions)
- remove the FIXME below.since with the drm_client
- infrastructure and the generic fbdev emulation we've
- resolved this all very neatly now.

V3: Add comments that This hook is deprecated
- new implementation methods instead of this hook

Signed-off-by: zhangzhijie <zhangzhijie@xxxxxxxxxxx>
Signed-off-by: ZhiJie.Zhang <zhangzhijie@xxxxxxxxxxx>
---
include/drm/drm_mode_config.h | 12 ++++++------
1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/include/drm/drm_mode_config.h b/include/drm/drm_mode_config.h
index ab424ddd7665..a084482d579a 100644
--- a/include/drm/drm_mode_config.h
+++ b/include/drm/drm_mode_config.h
@@ -103,14 +103,14 @@ struct drm_mode_config_funcs {
* Callback used by helpers to inform the driver of output configuration
* changes.
*
- * Drivers implementing fbdev emulation with the helpers can call
- * drm_fb_helper_hotplug_changed from this hook to inform the fbdev
+ * Drivers implementing fbdev emulation with the helpers. Drivers use
+ * drm_kms_helper_hotplug_event() to call this hook to inform the fbdev
* helper of output changes.
*
- * FIXME:
- *
- * Except that there's no vtable for device-level helper callbacks
- * there's no reason this is a core function.
+ * This hook is deprecated, drivers should instead use
+ * drm_fbdev_generic_setup() which takes care of any necessary
+ * hotplug event forwarding already without further involvement by
+ * the driver.
*/
void (*output_poll_changed)(struct drm_device *dev);

--
2.29.2