DOC: simplify figure_api.rst

jklymak · jklymak · commit a54c47fc7260 · 2020-09-16T16:12:19.000-07:00
diff --git a/doc/api/figure_api.rst b/doc/api/figure_api.rst
@@ -5,28 +5,6 @@
 .. currentmodule:: matplotlib.figure
 
 .. automodule:: matplotlib.figure
-   :no-members:
-   :no-inherited-members:
-
-Classes
--------
-
-.. autosummary::
-   :toctree: _as_gen/
-   :template: autosummary.rst
-   :nosignatures:
-
-   PanelBase
-   SubPanel
-   Figure
-   SubplotParams
-
-Functions
----------
-
-.. autosummary::
-   :toctree: _as_gen/
-   :template: autosummary.rst
-   :nosignatures:
-
-   figaspect
+   :members:
+   :inherited-members:
+   :exclude-members: AxesStack
diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
@@ -6,9 +6,9 @@
     Many methods are implimented in `PanelBase`.
 
 `SubPanel`
-    A logical figure inside a figure, usually added to a figure or parent
-    `SubPanel` with `.add_subpanel` or `.subpanels` methods (provisional
-    API v3.4).
+    A logical figure inside a figure, usually added to a figure (or parent
+    `SubPanel`) with `Figure.add_subpanel` or `Figure.subpanels` methods
+    (provisional API v3.4).
 
 `SubplotParams`
     Control the default spacing between subplots.
@@ -1434,7 +1434,7 @@ def subpanels(self, nrows=1, ncols=1, squeeze=True,
             The amount of width/height reserved for space between subpanels,
             expressed as a fraction of the average subpanel width.
             If not given, the values will be inferred from a figure or
-            rcParams when necessary. See also `GridSpec.get_subplot_params`.
+            rcParams when necessary.
 
         width_ratios : array-like of length *ncols*, optional
             Defines the relative widths of the columns. Each column gets a
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
@@ -1159,7 +1159,7 @@ def subplot(*args, **kwargs):
     two subplots that are otherwise identical to be added to the figure,
     make sure you give them unique labels.
 
-    In rare circumstances, `.add_subplot` may be called with a single
+    In rare circumstances, `Figure.add_subplot` may be called with a single
     argument, a subplot axes instance already created in the
     present figure but not in the figure's list of axes.
 
