DOC: Suggest replacement for tostring_rgb (#25502)

larsoner · web-flow · commit 2f7f62ea583d · 2023-03-22T21:08:52.000-04:00
* DOC: Suggest replacement

* DOC: Better doc

* DOC: Move
diff --git a/doc/api/next_api_changes/deprecations/25484-AL.rst b/doc/api/next_api_changes/deprecations/25484-AL.rst
@@ -1,3 +1,4 @@
 ``RendererAgg.tostring_rgb`` and ``FigureCanvasAgg.tostring_rgb``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-... are deprecated with no replacement.
+... are deprecated with no direct replacement. Consider using ``buffer_rgba``
+instead, which should cover most use cases.
diff --git a/lib/matplotlib/backends/backend_agg.py b/lib/matplotlib/backends/backend_agg.py
@@ -280,7 +280,7 @@ def buffer_rgba(self):
     def tostring_argb(self):
         return np.asarray(self._renderer).take([3, 0, 1, 2], axis=2).tobytes()
 
-    @_api.deprecated("3.8")
+    @_api.deprecated("3.8", alternative="buffer_rgba")
     def tostring_rgb(self):
         return np.asarray(self._renderer).take([0, 1, 2], axis=2).tobytes()
 
@@ -412,7 +412,7 @@ def get_renderer(self):
             self._lastKey = key
         return self.renderer
 
-    @_api.deprecated("3.8")
+    @_api.deprecated("3.8", alternative="buffer_rgba")
     def tostring_rgb(self):
         """
         Get the image as RGB `bytes`.
