DOC: update docs

jklymak · jklymak · commit 6cce6a5973b5 · 2022-12-12T10:54:42.000-08:00
diff --git a/doc/users/next_whats_new/legend-figure-outside.rst b/doc/users/next_whats_new/legend-figure-outside.rst
@@ -1,8 +1,10 @@
 :orphan:
 
-Figure legends now have *outside* keyword argument
---------------------------------------------------
-If a legend is made on a figure (or subfigure), and constrained_layout is being used, 
-then setting the *outside* kwarg to *True* on `.Figure.legend` will move axes to 
-make room for the legend.  See :doc:`/tutorials/intermediate/legend_guide` for an 
-example.  
+Figure legends can be placed outside figures using constrained_layout
+---------------------------------------------------------------------
+Constrained layout will make space for Figure legends if they are specified
+by a *loc* keyword argument that starts with the string "outside". The
+codes are unique from axes codes, in that "outside upper right" will
+make room at the top of the figure for the legend, whereas
+"outside right upper" will make room on the right-hand side of the figure.
+See :doc:`/tutorials/intermediate/legend_guide` for details.
diff --git a/examples/text_labels_and_annotations/figlegend_demo.py b/examples/text_labels_and_annotations/figlegend_demo.py
@@ -31,10 +31,10 @@
 
 ##############################################################################
 # Sometimes we do not want the legend to overlap the axes.  If you use
-# constrained_layout you can specify ``outside=True``, the legend will
-# not overlap.
+# constrained_layout you can specify "outside right upper", and
+# constrained_layout will make room for the legend.
 
-fig, axs = plt.subplots(1, 2, constrained_layout=True)
+fig, axs = plt.subplots(1, 2, layout='constrained')
 
 x = np.arange(0.0, 2.0, 0.02)
 y1 = np.sin(2 * np.pi * x)
@@ -47,7 +47,7 @@
 l3, = axs[1].plot(x, y3, color='tab:green')
 l4, = axs[1].plot(x, y4, color='tab:red', marker='^')
 
-fig.legend((l1, l2), ('Line 1', 'Line 2'), 'upper left')
-fig.legend((l3, l4), ('Line 3', 'Line 4'), 'upper right', outside=True)
+fig.legend((l1, l2), ('Line 1', 'Line 2'), loc='upper left')
+fig.legend((l3, l4), ('Line 3', 'Line 4'), loc='outside right upper')
 
 plt.show()
diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
@@ -1129,7 +1129,6 @@ def legend(self, *args, **kwargs):
                     loc = locs[0] + ' ' + locs[1]
 
         kwargs['loc'] = loc
-
         # explicitly set the bbox transform if the user hasn't.
         l = mlegend.Legend(self, handles, labels, *extra_args,
                            bbox_transform=transform, **kwargs)
