Added example in documentation of set_legend_options

src/sage/plot/graphics.py

@@ -309,7 +309,7 @@ def legend(self, show=None):
             sage: P.legend()
             False
             sage: P.legend(True)
-            sage: P  #  show with the legend
+            sage: P  # show with the legend
             Graphics object consisting of 1 graphics primitive
         """
         if show is None:
@@ -428,7 +428,17 @@ def set_legend_options(self, **kwds):
 
         ::
 
-            sage: p.set_legend_options(loc=(0.5,0.5)); p  # aligns the bottom of the box to the center                  # needs sage.symbolic
+            sage: p.set_legend_options(loc=(0.5,0.5)); p  # aligns the bottom of the box to the center                # needs sage.symbolic
+            Graphics object consisting of 1 graphics primitive
+
+        The parameters ``loc`` and ``borderaxespad`` can be altered
+        in order to place the legend below the x-axis label or to
+        the left of the y-axis label::
+
+            sage: p = line([(0, 0), (1, 1)], legend_label='test')
+            sage: p.axes_labels(['X-Label', 'Y-Label'])  # adding labels for axes
+            sage: p.set_legend_options(loc=8, borderaxespad=-7.5-0.01*p.fontsize())
+            sage: p
             Graphics object consisting of 1 graphics primitive
         """
         if len(kwds) == 0: