Add get/set_in_layout to artist API docs. (#13436)

anntzer · ImportanceOfBeingErnest · commit 1d46a93248d6 · 2019-02-14T22:01:43.000+01:00
They don't seem to fit in any existing subsection and creating a section
just for them seems silly, so move them, together with other
single-entry subsections, to "misc.".

To compensate the loss of the "margins and autoscaling subsection", add
mention of autoscaling in the first line of the sticky_edges docstring,
to keep that term ctrl-f'able on the API docs page.
diff --git a/doc/api/artist_api.rst b/doc/api/artist_api.rst
@@ -43,15 +43,6 @@ Interactive
    Artist.set_picker
    Artist.get_picker
 
-Margins and Autoscaling
------------------------
-
-.. autosummary::
-   :toctree: _as_gen
-   :nosignatures:
-
-   Artist.sticky_edges
-
 Clipping
 --------
 
@@ -171,13 +162,16 @@ Metadata
    Artist.set_url
    Artist.get_url
 
-Stale
------
+Miscellaneous
+-------------
 
 .. autosummary::
    :toctree: _as_gen
    :nosignatures:
 
+   Artist.sticky_edges
+   Artist.set_in_layout
+   Artist.get_in_layout
    Artist.stale
 
 Functions
diff --git a/lib/matplotlib/artist.py b/lib/matplotlib/artist.py
@@ -998,16 +998,16 @@ def set_zorder(self, level):
     @property
     def sticky_edges(self):
         """
-        `x` and `y` sticky edge lists.
+        ``x`` and ``y`` sticky edge lists for autoscaling.
 
         When performing autoscaling, if a data limit coincides with a value in
         the corresponding sticky_edges list, then no margin will be added--the
         view limit "sticks" to the edge. A typical use case is histograms,
         where one usually expects no margin on the bottom edge (0) of the
         histogram.
 
-        This attribute cannot be assigned to; however, the `x` and `y` lists
-        can be modified in place as needed.
+        This attribute cannot be assigned to; however, the ``x`` and ``y``
+        lists can be modified in place as needed.
 
         Examples
         --------
