API: use 'best' for default legend location

tacaswell · mdboom · commit dc5a93e3f2e9 · 2016-01-04T10:04:49.000-05:00
Closes #4671
diff --git a/lib/matplotlib/rcsetup.py b/lib/matplotlib/rcsetup.py
@@ -1020,7 +1020,7 @@ def validate_hist_bins(s):
     'legend.fancybox': [False, validate_bool],
 
     # at some point, legend.loc should be changed to 'best'
-    'legend.loc': ['upper right', validate_legend_loc],
+    'legend.loc': ['best', validate_legend_loc],
 
     # this option is internally ignored - it never served any useful purpose
     'legend.isaxes': [True, validate_bool],
diff --git a/matplotlibrc.template b/matplotlibrc.template
@@ -366,6 +366,7 @@ backend      : %(backend)s
 ### Legend
 #legend.fancybox      : False  # if True, use a rounded box for the
                                # legend, else a rectangle
+#legend.loc           : best
 #legend.isaxes        : True
 #legend.numpoints     : 1      # the number of points in the legend line
 #legend.fontsize      : large
