translucent legend background; remove legend.isaxes; scatterpoints=1

efiring · efiring · commit 64accfdf554c · 2016-05-23T10:05:09.000-10:00
diff --git a/lib/matplotlib/__init__.py b/lib/matplotlib/__init__.py
@@ -861,7 +861,7 @@ def matplotlib_fname():
 _deprecated_ignore_map = {
     }
 
-_obsolete_set = set(['tk.pythoninspect', ])
+_obsolete_set = set(['tk.pythoninspect', 'legend.isaxes'])
 _all_deprecated = set(chain(_deprecated_ignore_map,
                             _deprecated_map, _obsolete_set))
 
@@ -880,6 +880,8 @@ class RcParams(dict):
                     if key not in _all_deprecated)
     msg_depr = "%s is deprecated and replaced with %s; please use the latter."
     msg_depr_ignore = "%s is deprecated and ignored. Use %s"
+    msg_obsolete = ("%s is obsolete. Please remove it from your matplotlibrc "
+                    "and/or style files.")
 
     # validate values on the way in
     def __init__(self, *args, **kwargs):
@@ -897,6 +899,9 @@ def __setitem__(self, key, val):
                 alt = _deprecated_ignore_map[key]
                 warnings.warn(self.msg_depr_ignore % (key, alt))
                 return
+            elif key in _obsolete_set:
+                warnings.warn(self.msg_obsolete % (key,))
+                return
             try:
                 cval = self.validate[key](val)
             except ValueError as ve:
@@ -918,6 +923,10 @@ def __getitem__(self, key):
             warnings.warn(self.msg_depr_ignore % (key, alt))
             key = alt
 
+        elif key in _obsolete_set:
+            warnings.warn(self.msg_obsolete % (key,))
+            return None
+
         val = dict.__getitem__(self, key)
         if inverse_alt is not None:
             return inverse_alt(val)
diff --git a/lib/matplotlib/rcsetup.py b/lib/matplotlib/rcsetup.py
@@ -1103,22 +1103,18 @@ def validate_hist_bins(s):
     #legend properties
     'legend.fancybox': [True, validate_bool],
     'legend.loc': ['best', validate_legend_loc],
-
-    # this option is internally ignored - it never served any useful purpose
-    'legend.isaxes': [True, validate_bool],
-
     # the number of points in the legend line
     'legend.numpoints': [1, validate_int],
     # the number of points in the legend line for scatter
-    'legend.scatterpoints': [3, validate_int],
+    'legend.scatterpoints': [1, validate_int],
     'legend.fontsize': ['small', validate_fontsize],
      # the relative size of legend markers vs. original
     'legend.markerscale': [1.0, validate_float],
     'legend.shadow': [False, validate_bool],
      # whether or not to draw a frame around legend
-    'legend.frameon': [False, validate_bool],
+    'legend.frameon': [True, validate_bool],
      # alpha value of the legend frame
-    'legend.framealpha': [None, validate_float_or_None],
+    'legend.framealpha': [0.8, validate_float_or_None],
 
     ## the following dimensions are in fraction of the font size
     'legend.borderpad': [0.4, validate_float],  # units are fontsize
@@ -1138,7 +1134,7 @@ def validate_hist_bins(s):
     'legend.markerscale': [1.0, validate_float],
     'legend.shadow': [False, validate_bool],
     'legend.facecolor': ['inherit', validate_color_or_inherit],
-    'legend.edgecolor': ['k', validate_color_or_inherit],
+    'legend.edgecolor': ['none', validate_color_or_inherit],
 
     # tick properties
     'xtick.top':         [True, validate_bool],   # draw ticks on the top side
diff --git a/matplotlibrc.template b/matplotlibrc.template
@@ -395,15 +395,15 @@ backend      : $TEMPLATE_BACKEND
 
 ### Legend
 #legend.loc           : best
-#legend.frameon       : False    # whether or not to draw a frame around legend
-#legend.framealpha    : None     # legend frame transparency
+#legend.frameon       : True     # whether or not to draw a frame around legend
+#legend.framealpha    : 0.8      # legend frame transparency
 #legend.facecolor     : inherit  # inherit from axes.facecolor; or color spec
-#legend.edgecolor     : k
+#legend.edgecolor     : none
 #legend.fancybox      : True     # if True, use a rounded box for the
                                  # legend, else a rectangle
 #legend.shadow        : False
 #legend.numpoints     : 1        # the number of marker points in the legend line
-#legend.scatterpoints : 3        # number of scatter points
+#legend.scatterpoints : 1        # number of scatter points
 #legend.markerscale   : 1.0      # the relative size of legend markers vs. original
 #legend.fontsize      : small
 # Dimensions as fraction of fontsize:
