Merge pull request #24358 from meeseeksmachine/auto-backport-of-pr-24354-on-v3.6.x

oscargus · web-flow · commit dca6c7a75866 · 2022-11-03T22:56:25.000+01:00
Backport PR #24354 on branch v3.6.x (DOC: clarify rc_context resets all rcParams changes)
diff --git a/lib/matplotlib/__init__.py b/lib/matplotlib/__init__.py
@@ -1062,6 +1062,9 @@ def rc_context(rc=None, fname=None):
 
     The :rc:`backend` will not be reset by the context manager.
 
+    rcParams changed both through the context manager invocation and
+    in the body of the context will be reset on context exit.
+
     Parameters
     ----------
     rc : dict
@@ -1089,6 +1092,13 @@ def rc_context(rc=None, fname=None):
          with mpl.rc_context(fname='print.rc'):
              plt.plot(x, y)  # uses 'print.rc'
 
+    Setting in the context body::
+
+        with mpl.rc_context():
+            # will be reset
+            mpl.rcParams['lines.linewidth'] = 5
+            plt.plot(x, y)
+
     """
     orig = dict(rcParams.copy())
     del orig['backend']
