DOC: clarify rc_context resets all rcParams changes

tacaswell · tacaswell · commit 724387e5d7d0 · 2022-11-03T14:28:33.000-04:00
Inspired by #24351
diff --git a/lib/matplotlib/__init__.py b/lib/matplotlib/__init__.py
@@ -1080,6 +1080,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
@@ -1107,6 +1110,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']
