Document that GridSpec.get_subplot_params ignores gridspec.figure.

It may not be the nicest API, but let's at least document it.

Author: anntzer

lib/matplotlib/gridspec.py

@@ -418,6 +418,8 @@ def get_subplot_params(self, figure=None):
         - non-*None* attributes of the GridSpec
         - the provided *figure*
         - :rc:`figure.subplot.*`
+
+        Note that the ``figure`` attribute of the GridSpec is always ignored.
         """
         if figure is None:
             kw = {k: mpl.rcParams["figure.subplot."+k]