add docstring

Author: Moritz Schreiber

pandas/plotting/_core.py

@@ -1643,6 +1643,14 @@ def scatter(self, x, y, s=None, c=None, **kwargs):
               marker points according to a colormap.
 
         **kwargs
+            size : str, int or array-like, optional
+                    The color of each point. Alias for `s`.
+                    `s` and `size` aren't allowed at the same time.
+                    .. versionadded:: 1.4.1
+            color : str, int or array-like, optional
+                    The color of each point. Alias for `c`.
+                    `c` and `color` aren't allowed at the same time.
+                    .. versionadded:: 1.4.1
             Keyword arguments to pass on to :meth:`DataFrame.plot`.
 
         Returns

pandas/tests/plotting/frame/test_frame_color.py

@@ -119,14 +119,10 @@ def test_bar_colors(self):
         tm.close()
 
         custom_colors = "rgcby"
-        ax = df.plot.bar(color=custom_colors)
-        self._check_colors(ax.patches[::5], facecolors=custom_colors)
-        tm.close()
-
-        custom_colors = "rgcby"
-        ax = df.plot.bar(c=custom_colors)
-        self._check_colors(ax.patches[::5], facecolors=custom_colors)
-        tm.close()
+        for kw in ["c", "color"]:
+            ax = df.plot.bar(**{kw: "rgcby"})
+            self._check_colors(ax.patches[::5], facecolors=custom_colors)
+            tm.close()
 
         from matplotlib import cm
 
@@ -142,19 +138,17 @@ def test_bar_colors(self):
         self._check_colors(ax.patches[::5], facecolors=rgba_colors)
         tm.close()
 
-        ax = df.loc[:, [0]].plot.bar(color="DodgerBlue")
-        self._check_colors([ax.patches[0]], facecolors=["DodgerBlue"])
-        tm.close()
-
-        ax = df.loc[:, [0]].plot.bar(c="DodgerBlue")
-        self._check_colors([ax.patches[0]], facecolors=["DodgerBlue"])
-        tm.close()
+        for kw in ["c", "color"]:
+            ax = df.loc[:, [0]].plot.bar(**{kw: "DodgerBlue"})
+            self._check_colors([ax.patches[0]], facecolors=["DodgerBlue"])
+            tm.close()
 
         ax = df.plot(kind="bar", color="green")
         self._check_colors(ax.patches[::5], facecolors=["green"] * 5)
         tm.close()
 
-    def test_bar_user_colors(self):
+    @pytest.mark.parametrize("kw", ["c", "color"])
+    def test_bar_user_colors(self, kw):
         df = DataFrame(
             {"A": range(4), "B": range(1, 5), "color": ["red", "blue", "blue", "red"]}
         )