[PATCH v3] drm: Improve the output_poll_changed description

[Thomas Zimmermann]

Hi

Am 18.01.21 um 02:22 schrieb ZhiJie.Zhang:
> From: zhangzhijie <zhangzhijie at loongson.cn>
> 
> 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 at loongson.cn>
> Signed-off-by: ZhiJie.Zhang <zhangzhijie at loongson.cn>
> ---
>   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

I don't understand this. Maybe it's "Drivers implementing fbdev 
emulation use drm_kms_helper_hotplug_event() to call ..." ?

Best regards
Thomas

>   	 * 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);
>   
> 

-- 
Thomas Zimmermann
Graphics Driver Developer
SUSE Software Solutions Germany GmbH
Maxfeldstr. 5, 90409 Nürnberg, Germany
(HRB 36809, AG Nürnberg)
Geschäftsführer: Felix Imendörffer

-------------- next part --------------
A non-text attachment was scrubbed...
Name: OpenPGP_signature
Type: application/pgp-signature
Size: 840 bytes
Desc: OpenPGP digital signature
URL: <https://lists.freedesktop.org/archives/dri-devel/attachments/20210118/b93c75e5/attachment.sig>