DOC: add warning note to imsave

tacaswell · tacaswell · commit 4d088f2c6b52 · 2022-10-31T17:12:41.000-04:00
closes #3657
diff --git a/lib/matplotlib/image.py b/lib/matplotlib/image.py
@@ -1547,7 +1547,15 @@ def imread(fname, format=None):
 def imsave(fname, arr, vmin=None, vmax=None, cmap=None, format=None,
            origin=None, dpi=100, *, metadata=None, pil_kwargs=None):
     """
-    Save an array as an image file.
+    Colormap and save an array as an image file.
+
+    RGB(A) images are passed through, single channel images will be
+    saved in false color.
+
+    .. note ::
+
+       If you want to save a single channel image as gray scale please use an
+       image I/O library (such as pillow, tifffile, or imageio) directly.
 
     Parameters
     ----------
