DOC: Added API entry, fixed Legend.get_tightbbox string

jklymak · jklymak · commit 68cf4580b14d · 2018-03-05T10:39:59.000-08:00
diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
@@ -4099,11 +4099,11 @@ def get_tightbbox(self, renderer, call_axes_locator=True,
 
         Parameters
         ----------
-        renderer : RendererBase instance
+        renderer : `.RendererBase` instance
             renderer that will be used to draw the figures (i.e.
             ``fig.canvas.get_renderer()``)
 
-        bbox_extra_artists : list of `Artist` or ``None``
+        bbox_extra_artists : list of `.Artist` or ``None``
             List of artists to include in the tight bounding box.  If
             ``None`` (default), then all artist children of the axes are
             included in the tight bounding box.
diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
@@ -2221,18 +2221,18 @@ def get_tightbbox(self, renderer, bbox_extra_artists=None):
 
         Parameters
         ----------
-        renderer : RendererBase instance
+        renderer : `.RendererBase` instance
             renderer that will be used to draw the figures (i.e.
             ``fig.canvas.get_renderer()``)
 
-        bbox_extra_artists : list of `Artist` or ``None``
+        bbox_extra_artists : list of `.Artist` or ``None``
             List of artists to include in the tight bounding box.  If
             ``None`` (default), then all artist children of each axes are
             included in the tight bounding box.
 
         Returns
         -------
-        `BboxBase` : containing the bounding box (in figure co-ordinates).
+        `.BboxBase` : containing the bounding box (in figure co-ordinates).
         """
 
         bb = []
diff --git a/lib/matplotlib/legend.py b/lib/matplotlib/legend.py
@@ -1126,7 +1126,20 @@ def get_window_extent(self, *args, **kwargs):
         return self.legendPatch.get_window_extent(*args, **kwargs)
 
     def get_tightbbox(self, renderer):
-        'Return extent of the legend.'
+        """
+        Like `.Legend.get_window_extent`, but uses the box for the legend.
+
+        Parameters
+        ----------
+        renderer : `.RendererBase` instance
+            renderer that will be used to draw the figures (i.e.
+            ``fig.canvas.get_renderer()``)
+
+        Returns
+        -------
+        `.BboxBase` : containing the bounding box (in figure-relative
+            co-ordinates).
+        """
         return self._legend_box.get_window_extent(renderer)
 
     def get_frame_on(self):
