DOC: tweak scatter docstring a bit

tacaswell · tacaswell · commit 7a23966b92ca · 2016-10-19T11:41:00.000-04:00
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -3811,8 +3811,10 @@ def scatter(self, x, y, s=None, c=None, marker=None, cmap=None, norm=None,
                 vmin=None, vmax=None, alpha=None, linewidths=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
         ----------
@@ -3863,7 +3865,8 @@ def scatter(self, x, y, s=None, c=None, marker=None, cmap=None, norm=None,
         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) and the size is normalized.
+            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'
