Update docs

mdboom · mdboom · commit 5743e715973f · 2016-03-22T09:35:12.000-04:00
diff --git a/doc/users/whats_new/style_changes.rst b/doc/users/whats_new/style_changes.rst
@@ -33,7 +33,7 @@ Plots
 
 - The default size of the elements in a scatter plot is now based on
   the rcParam ``lines.markersize`` so it is consistent with ``plot(X,
-  Y, 'o')``.  The old value was 20.
+  Y, 'o')``.  The old value was 20, and the new value is 36 (6^2).
 
 Plot layout
 ```````````
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -3739,8 +3739,8 @@ def scatter(self, x, y, s=None, c=None, marker='o', cmap=None, norm=None,
         x, y : array_like, shape (n, )
             Input data
 
-        s : scalar or array_like, shape (n, ), optional, default: 20
-            size in points^2.
+        s : scalar or array_like, shape (n, ), optional
+            size in points^2.  Default is `rcParams['lines.markersize'] ** 2`.
 
         c : color, sequence, or sequence of color, optional, default: 'b'
             `c` can be a single color format string, or a sequence of color
