DOC: fix API note about get_tightbbox

jklymak · jklymak · commit 9d2c9fbb1451 · 2018-09-20T11:06:42.000-07:00
diff --git a/doc/api/api_changes.rst b/doc/api/api_changes.rst
@@ -70,26 +70,34 @@ returned *image* now is of type `~.matplotlib.collections.QuadMesh`
 instead of `~.matplotlib.image.AxesImage`.
 
 
-`.matplotlib.Axes.get_tightbbox` now includes all artists
----------------------------------------------------------
+`.matplotlib.axes.Axes.get_tightbbox` now includes all artists
+--------------------------------------------------------------
+
+For Matplotlib 3.0, *all* artists are now included in the bounding box
+returned by `.matplotlib.axes.Axes.get_tightbbox`.
+
+`.matplotlib.axes.Axes.get_tightbbox` adds a new kwarg ``bbox_extra_artists``
+to specify the manually list of artists on the axes to include in the
+tight bounding box calculation.
 
 Layout tools like `.Figure.tight_layout`, ``constrained_layout``,
 and ``fig.savefig('fname.png', bbox_inches="tight")`` use
-`.matplotlib.Axes.get_tightbbox` to determine the bounds of each axes on
+`.matplotlib.axes.Axes.get_tightbbox` to determine the bounds of each axes on
 a figure and adjust spacing between axes.
 
 In Matplotlib 2.2 ``get_tightbbox`` started to include legends made on the
 axes, but still excluded some other artists, like text that may overspill an
-axes.  For Matplotlib 3.0, *all* artists are now included in the bounding box.
+axes.  This has been expanded to include *all* artists.
 
-This new default may be overridden in either of two ways:
+This new default may be overridden in either of three ways:
 
 1. Make the artist to be excluded a child of the figure, not the axes. E.g.,
    call ``fig.legend()`` instead of ``ax.legend()`` (perhaps using
-   `~.matplotlib.Axes.get_legend_handles_labels` to gather handles and labels
-   from the parent axes).
+   `~.matplotlib.axes.Axes.get_legend_handles_labels` to gather handles and
+   labels from the parent axes).
 2. If the artist is a child of the axes, set the artist property
    ``artist.set_in_layout(False)``.
+3. Manually specify a list of artists in the new kwarg ``bbox_extra_artists``.
 
 
 `Text.set_text` with string argument ``None`` sets string to empty
