[PATCH] drm/mipi-dsi: docs: Mark mipi_dsi_compression_mode() as deprecated

Nicolás Antinori <[email protected]> Thu, 2 Jul 2026 16:42:18 -0300
Newsgroups dev.linux.lists.linux-kernel-mentees,org.freedesktop.lists.dri-devel,org.kernel.vger.linux-kernel
Message-ID <[email protected]>
The mipi_dsi_compression_mode() function is a thin wrapper around
mipi_dsi_compression_mode_ext(), which is already marked as deprecated.
Additionally, the non-deprecated mipi_dsi_compression_mode_multi()
alternative exists.

Document this deprecation to encourage developers to use the multi variant.

Signed-off-by: Nicolás Antinori <[email protected]>
---
 drivers/gpu/drm/drm_mipi_dsi.c | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/drivers/gpu/drm/drm_mipi_dsi.c b/drivers/gpu/drm/drm_mipi_dsi.c
index 3ac1dd5ad640..9e20818f2de0 100644
--- a/drivers/gpu/drm/drm_mipi_dsi.c
+++ b/drivers/gpu/drm/drm_mipi_dsi.c
@@ -699,6 +699,8 @@ EXPORT_SYMBOL(mipi_dsi_compression_mode_ext);
  * Enable or disable Display Stream Compression on the peripheral using the
  * default Picture Parameter Set and VESA DSC 1.1 algorithm.
  *
+ * This function is deprecated. Use mipi_dsi_compression_mode_multi() instead.
+ *
  * Return: 0 on success or a negative error code on failure.
  */
 int mipi_dsi_compression_mode(struct mipi_dsi_device *dsi, bool enable)
--
2.47.3