Merge pull request #6963 from tacaswell/doc_scatter_verts

NelleV · web-flow · commit 954d6620a14f · 2016-10-19T13:16:11.000-07:00
DOC: Document `verts` in scatter
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -3841,8 +3841,9 @@ def scatter(self, x, y, s=None, c=None, marker=None, cmap=None, norm=None,
                 verts=None, edgecolors=None,
                 **kwargs):
         """
-        Make a scatter plot of x vs y, where x and y are sequence like objects
-        of the same length.
+        Make a scatter plot of `x` vs `y`
+
+        Marker size is scaled by `s` and marker color is mapped to `c`
 
         Parameters
         ----------
@@ -3890,6 +3891,12 @@ def scatter(self, x, y, s=None, c=None, marker=None, cmap=None, norm=None,
         linewidths : scalar or array_like, optional, default: None
             If None, defaults to (lines.linewidth,).
 
+        verts : sequence of (x, y), optional
+            If `marker` is None, these vertices will be used to
+            construct the marker.  The center of the marker is located
+            at (0,0) in normalized units.  The overall marker is rescaled
+            by ``s``.
+
         edgecolors : color or sequence of color, optional, default: None
             If None, defaults to 'face'
 
