[PATCH 0/3] drm: docs: mention currently recommended API instead of deprecated ones

[PATCH 0/3] drm: docs: mention currently recommended API instead of deprecated ones

[Luca Ceresoli]

This series replaces references to deprecated functions in the docs with
the current recommended API.

Signed-off-by: Luca Ceresoli <luca.ceresoli@bootlin.com>
---
Luca Ceresoli (3):
      drm/bridge: stop mentioning deprecated devm_drm_of_get_bridge() in docs
      drm/panel: stop mentioning deprecated devm_drm_of_get_bridge() in docs
      drm/drv: stop mentioning deprecated drm_of_find_panel_or_bridge() in docs

 drivers/gpu/drm/drm_bridge.c | 5 +++--
 drivers/gpu/drm/drm_drv.c    | 8 ++++----
 drivers/gpu/drm/drm_panel.c  | 3 +--
 3 files changed, 8 insertions(+), 8 deletions(-)
---
base-commit: 73df79cceb8c01f311055a61794e229dc81546cb
change-id: 20261012-drm-bridge-every-panel-cleanups-f952bf8287cc

Best regards,
--  
Luca Ceresoli, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com

text:
Return-Path: <luca.ceresoli@bootlin.com>
Delivered-To: luca.ceresoli@bootlin.com
Received: from mail.galae.net ([172.22.1.253])
	by 9e7fea892943 with LMTP
	id aFjoM/XuzGpsHhEAtaWaaQ
	(envelope-from <luca.ceresoli@bootlin.com>)
	for <luca.ceresoli@bootlin.com>; Mon, 12 Oct 2026 16:30:13 +0200
X-Original-To: luca.ceresoli@bootlin.com
Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 888F911D70CC0;
	Mon, 12 Oct 2026 16:29:59 +0200 (CEST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim;
	t=1791815408; h=from:subject:date:message-id:to:cc:mime-version:content-type:
	 content-transfer-encoding; bh=fHD6zSsrxg7Ukx1n42kcY5qUaVBs+GhRS0EahN2FxFA=;
	b=xtIvgHpXYfpGGsRXyeI0tHz7zvmhiVQ9R3X41/ulmzClKScwiaOrzCOg3qyRTKnkavQr8A
	9/HLZtBNs12hkVPqh5251D4NU7YlBnG6/TpDHuSJjBACiCZK+xQs3ckyfgGirasopK+Yqh
	XrKenCO0HbUSQkEh93WRwcGT63m8W75o9zeTINXObRQIpDeSsDlx1j/kdOzjl1HxlmduoP
	BwepzRpfbTUkNhAXmkOqQRv1hSWuTKW9mlkzZsm7HshZqysdlZ0q76yQ0MhUtRkmvZRK77
	J8OBVo2KIEADkLH78ALqnw6bNakQ4aVDRZdVdNuRZQczC6j7nslIltR2KpK3fg==
From: Luca Ceresoli <luca.ceresoli@bootlin.com>
Subject: [PATCH 0/3] drm: docs: mention currently recommended API instead
 of deprecated ones
Date: Mon, 12 Oct 2026 16:29:50 +0200
Message-Id: <20261012-drm-bridge-every-panel-cleanups-v1-0-0fd272f486b6@bootlin.com>
MIME-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 7bit
X-B4-Tracking: v=1; b=H4sIAAAAAAAC/yXN0QrCMAyF4VcZuTawFtTpq4gXbZpqZNaSuKGMv
 btVLz8O/GcBYxU2OHYLKM9i8igNbtMBXUO5MEpqBt/7neudx6R3jCqpLTyzvrGGwiPSyKFM1TA
 ftj7mwQ97ImiVqpzl9Xs4nf+2Kd6Ynt8srOsH0wM+aIMAAAA=
X-Change-ID: 20261012-drm-bridge-every-panel-cleanups-f952bf8287cc
To: Andrzej Hajda <andrzej.hajda@intel.com>, 
 Neil Armstrong <neil.armstrong@linaro.org>, Robert Foss <rfoss@kernel.org>, 
 Laurent Pinchart <Laurent.pinchart@ideasonboard.com>, 
 Jonas Karlman <jonas@kwiboo.se>, Jernej Skrabec <jernej.skrabec@gmail.com>, 
 Maarten Lankhorst <maarten.lankhorst@linux.intel.com>, 
 Maxime Ripard <mripard@kernel.org>, Thomas Zimmermann <tzimmermann@suse.de>, 
 David Airlie <airlied@gmail.com>, Simona Vetter <simona@ffwll.ch>, 
 Jessica Zhang <jesszhan0024@gmail.com>
Cc: Icenowy Zheng <zhengxingda@iscas.ac.cn>, 
 Hui Pu <Hui.Pu@gehealthcare.com>, Ian Ray <ian.ray@gehealthcare.com>, 
 Thomas Petazzoni <thomas.petazzoni@bootlin.com>, 
 dri-devel@lists.freedesktop.org, linux-kernel@vger.kernel.org, 
 Luca Ceresoli <luca.ceresoli@bootlin.com>
X-Mailer: b4 0.16.0
X-Last-TLS-Session-Version: TLSv1.3

This series replaces references to deprecated functions in the docs with
the current recommended API.

Signed-off-by: Luca Ceresoli <luca.ceresoli@bootlin.com>
---
Luca Ceresoli (3):
      drm/bridge: stop mentioning deprecated devm_drm_of_get_bridge() in docs
      drm/panel: stop mentioning deprecated devm_drm_of_get_bridge() in docs
      drm/drv: stop mentioning deprecated drm_of_find_panel_or_bridge() in docs

 drivers/gpu/drm/drm_bridge.c | 5 +++--
 drivers/gpu/drm/drm_drv.c    | 8 ++++----
 drivers/gpu/drm/drm_panel.c  | 3 +--
 3 files changed, 8 insertions(+), 8 deletions(-)
---
base-commit: 73df79cceb8c01f311055a61794e229dc81546cb
change-id: 20261012-drm-bridge-every-panel-cleanups-f952bf8287cc

Best regards,
--  
Luca Ceresoli, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com

[PATCH 1/3] drm/bridge: stop mentioning deprecated devm_drm_of_get_bridge() in docs

[Luca Ceresoli]

devm_drm_of_get_bridge() is deprecated. Update the "display driver
integration" docs by mentioning the currently recommended API.

Link: https://lore.kernel.org/all/c1b065c8bd926708500b7c42864279e055ed95d0.camel@iscas.ac.cn/
Suggested-by: Icenowy Zheng <zhengxingda@iscas.ac.cn>
Signed-off-by: Luca Ceresoli <luca.ceresoli@bootlin.com>
---
 drivers/gpu/drm/drm_bridge.c | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/drivers/gpu/drm/drm_bridge.c b/drivers/gpu/drm/drm_bridge.c
index e7f9e6d58927..e259d078f7de 100644
--- a/drivers/gpu/drm/drm_bridge.c
+++ b/drivers/gpu/drm/drm_bridge.c
@@ -68,8 +68,9 @@
  *
  * Display drivers are responsible for linking encoders with the first bridge
  * in the chains. This is done by acquiring the appropriate bridge with
- * devm_drm_of_get_bridge(). Once acquired, the bridge shall be attached to the
- * encoder with a call to drm_bridge_attach().
+ * of_drm_get_bridge_by_endpoint() or of_drm_find_and_get_bridge(). Once
+ * acquired, the bridge shall be attached to the encoder with a call to
+ * drm_bridge_attach().
  *
  * Bridges are responsible for linking themselves with the next bridge in the
  * chain, if any. This is done the same way as for encoders, with the call to

-- 
2.56.0

[PATCH 2/3] drm/panel: stop mentioning deprecated devm_drm_of_get_bridge() in docs

[Luca Ceresoli]

The kernel-doc for drm_of_find_panel_or_bridge() still mentions
devm_drm_of_get_bridge() which is deprecated. Update to mention the
currently recommended API.

Link: https://lore.kernel.org/all/c1b065c8bd926708500b7c42864279e055ed95d0.camel@iscas.ac.cn/
Suggested-by: Icenowy Zheng <zhengxingda@iscas.ac.cn>
Signed-off-by: Luca Ceresoli <luca.ceresoli@bootlin.com>
---
 drivers/gpu/drm/drm_panel.c | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/drivers/gpu/drm/drm_panel.c b/drivers/gpu/drm/drm_panel.c
index c00529bfb706..8f35654c4650 100644
--- a/drivers/gpu/drm/drm_panel.c
+++ b/drivers/gpu/drm/drm_panel.c
@@ -1039,8 +1039,7 @@ EXPORT_SYMBOL(of_drm_find_panel);
  * return either the associated struct drm_panel or drm_bridge device.
  *
  * This function is deprecated and should not be used in new drivers. Use
- * of_drm_get_bridge_by_endpoint() instead when not looking for a panel, or
- * devm_drm_of_get_bridge() otherwise.
+ * of_drm_get_bridge_by_endpoint() instead.
  *
  * Returns zero if successful, or one of the standard error codes if it fails.
  */

-- 
2.56.0

[PATCH 3/3] drm/drv: stop mentioning deprecated drm_of_find_panel_or_bridge() in docs

[Luca Ceresoli]

drm_of_find_panel_or_bridge() is deprecated. Update the "component helper
usage recommendations" docs by mentioning the currently recommended API.

Also stop mentioning drm_panel because now every drm_panel embeds a
drm_bridge and the drm_bridge API is recommended to access panels too.

Signed-off-by: Luca Ceresoli <luca.ceresoli@bootlin.com>
---
 drivers/gpu/drm/drm_drv.c | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/drivers/gpu/drm/drm_drv.c b/drivers/gpu/drm/drm_drv.c
index 0cdc606af8d1..3f1b7faf5bef 100644
--- a/drivers/gpu/drm/drm_drv.c
+++ b/drivers/gpu/drm/drm_drv.c
@@ -695,10 +695,10 @@ static void drm_fs_inode_free(struct inode *inode)
  *
  *  - The component helper fills the niche where further standardization of
  *    interfaces is not practical. When there already is, or will be, a
- *    standardized interface like &drm_bridge or &drm_panel, providing its own
- *    functions to find such components at driver load time, like
- *    drm_of_find_panel_or_bridge(), then the component helper should not be
- *    used.
+ *    standardized interface like &drm_bridge providing its own functions
+ *    to find such components at driver load time, like
+ *    of_drm_get_bridge_by_endpoint() and of_drm_find_and_get_bridge(),
+ *    then the component helper should not be used.
  */
 
 static void drm_dev_init_release(struct drm_device *dev, void *res)

-- 
2.56.0

Re: [PATCH 1/3] drm/bridge: stop mentioning deprecated devm_drm_of_get_bridge() in docs

[Laurent Pinchart]

On Mon, Oct 12, 2026 at 04:29:51PM +0200, Luca Ceresoli wrote:
> devm_drm_of_get_bridge() is deprecated. Update the "display driver
> integration" docs by mentioning the currently recommended API.
> 
> Link: https://lore.kernel.org/all/c1b065c8bd926708500b7c42864279e055ed95d0.camel@iscas.ac.cn/
> Suggested-by: Icenowy Zheng <zhengxingda@iscas.ac.cn>
> Signed-off-by: Luca Ceresoli <luca.ceresoli@bootlin.com>

Reviewed-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>

> ---
>  drivers/gpu/drm/drm_bridge.c | 5 +++--
>  1 file changed, 3 insertions(+), 2 deletions(-)
> 
> diff --git a/drivers/gpu/drm/drm_bridge.c b/drivers/gpu/drm/drm_bridge.c
> index e7f9e6d58927..e259d078f7de 100644
> --- a/drivers/gpu/drm/drm_bridge.c
> +++ b/drivers/gpu/drm/drm_bridge.c
> @@ -68,8 +68,9 @@
>   *
>   * Display drivers are responsible for linking encoders with the first bridge
>   * in the chains. This is done by acquiring the appropriate bridge with
> - * devm_drm_of_get_bridge(). Once acquired, the bridge shall be attached to the
> - * encoder with a call to drm_bridge_attach().
> + * of_drm_get_bridge_by_endpoint() or of_drm_find_and_get_bridge(). Once
> + * acquired, the bridge shall be attached to the encoder with a call to
> + * drm_bridge_attach().
>   *
>   * Bridges are responsible for linking themselves with the next bridge in the
>   * chain, if any. This is done the same way as for encoders, with the call to

-- 
Regards,

Laurent Pinchart

Re: [PATCH 3/3] drm/drv: stop mentioning deprecated drm_of_find_panel_or_bridge() in docs

[Laurent Pinchart]

On Mon, Oct 12, 2026 at 04:29:53PM +0200, Luca Ceresoli wrote:
> drm_of_find_panel_or_bridge() is deprecated. Update the "component helper
> usage recommendations" docs by mentioning the currently recommended API.
> 
> Also stop mentioning drm_panel because now every drm_panel embeds a
> drm_bridge and the drm_bridge API is recommended to access panels too.
> 
> Signed-off-by: Luca Ceresoli <luca.ceresoli@bootlin.com>

Reviewed-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>

> ---
>  drivers/gpu/drm/drm_drv.c | 8 ++++----
>  1 file changed, 4 insertions(+), 4 deletions(-)
> 
> diff --git a/drivers/gpu/drm/drm_drv.c b/drivers/gpu/drm/drm_drv.c
> index 0cdc606af8d1..3f1b7faf5bef 100644
> --- a/drivers/gpu/drm/drm_drv.c
> +++ b/drivers/gpu/drm/drm_drv.c
> @@ -695,10 +695,10 @@ static void drm_fs_inode_free(struct inode *inode)
>   *
>   *  - The component helper fills the niche where further standardization of
>   *    interfaces is not practical. When there already is, or will be, a
> - *    standardized interface like &drm_bridge or &drm_panel, providing its own
> - *    functions to find such components at driver load time, like
> - *    drm_of_find_panel_or_bridge(), then the component helper should not be
> - *    used.
> + *    standardized interface like &drm_bridge providing its own functions
> + *    to find such components at driver load time, like
> + *    of_drm_get_bridge_by_endpoint() and of_drm_find_and_get_bridge(),
> + *    then the component helper should not be used.
>   */
>  
>  static void drm_dev_init_release(struct drm_device *dev, void *res)

-- 
Regards,

Laurent Pinchart

Re: [PATCH 1/3] drm/bridge: stop mentioning deprecated devm_drm_of_get_bridge() in docs

[Dmitry Baryshkov]

On Mon, Oct 12, 2026 at 04:29:51PM +0200, Luca Ceresoli wrote:
> devm_drm_of_get_bridge() is deprecated. Update the "display driver
> integration" docs by mentioning the currently recommended API.
> 
> Link: https://lore.kernel.org/all/c1b065c8bd926708500b7c42864279e055ed95d0.camel@iscas.ac.cn/
> Suggested-by: Icenowy Zheng <zhengxingda@iscas.ac.cn>
> Signed-off-by: Luca Ceresoli <luca.ceresoli@bootlin.com>
> ---
>  drivers/gpu/drm/drm_bridge.c | 5 +++--
>  1 file changed, 3 insertions(+), 2 deletions(-)
> 

Reviewed-by: Dmitry Baryshkov <dmitry.baryshkov@oss.qualcomm.com>


-- 
With best wishes
Dmitry

Re: [PATCH 2/3] drm/panel: stop mentioning deprecated devm_drm_of_get_bridge() in docs

[Dmitry Baryshkov]

On Mon, Oct 12, 2026 at 04:29:52PM +0200, Luca Ceresoli wrote:
> The kernel-doc for drm_of_find_panel_or_bridge() still mentions
> devm_drm_of_get_bridge() which is deprecated. Update to mention the
> currently recommended API.
> 
> Link: https://lore.kernel.org/all/c1b065c8bd926708500b7c42864279e055ed95d0.camel@iscas.ac.cn/
> Suggested-by: Icenowy Zheng <zhengxingda@iscas.ac.cn>
> Signed-off-by: Luca Ceresoli <luca.ceresoli@bootlin.com>
> ---
>  drivers/gpu/drm/drm_panel.c | 3 +--
>  1 file changed, 1 insertion(+), 2 deletions(-)
> 

Reviewed-by: Dmitry Baryshkov <dmitry.baryshkov@oss.qualcomm.com>


-- 
With best wishes
Dmitry

Re: [PATCH 3/3] drm/drv: stop mentioning deprecated drm_of_find_panel_or_bridge() in docs

[Dmitry Baryshkov]

On Tue, Oct 13, 2026 at 02:14:50PM +0200, Laurent Pinchart wrote:
> On Mon, Oct 12, 2026 at 04:29:53PM +0200, Luca Ceresoli wrote:
> > drm_of_find_panel_or_bridge() is deprecated. Update the "component helper
> > usage recommendations" docs by mentioning the currently recommended API.
> > 
> > Also stop mentioning drm_panel because now every drm_panel embeds a
> > drm_bridge and the drm_bridge API is recommended to access panels too.
> > 
> > Signed-off-by: Luca Ceresoli <luca.ceresoli@bootlin.com>
> 
> Reviewed-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>

Reviewed-by: Dmitry Baryshkov <dmitry.baryshkov@oss.qualcomm.com>


-- 
With best wishes
Dmitry