matplotlib
diff --git a/‎doc/users/next_whats_new/2018_12_03_sphinx_plot_preserve.rst
Copy file name to clipboardExpand all lines: doc/users/next_whats_new/2018_12_03_sphinx_plot_preserve.rst
+6-6Lines changed: 6 additions & 6 deletions b/‎doc/users/next_whats_new/2018_12_03_sphinx_plot_preserve.rst
Copy file name to clipboardExpand all lines: doc/users/next_whats_new/2018_12_03_sphinx_plot_preserve.rst
+6-6Lines changed: 6 additions & 6 deletions
diff --git a/‎lib/matplotlib/sphinxext/plot_directive.py
Copy file name to clipboardExpand all lines: lib/matplotlib/sphinxext/plot_directive.py
+9-9Lines changed: 9 additions & 9 deletions b/‎lib/matplotlib/sphinxext/plot_directive.py
Copy file name to clipboardExpand all lines: lib/matplotlib/sphinxext/plot_directive.py
+9-9Lines changed: 9 additions & 9 deletions
@@ -1,5 +1,5 @@
-Plot Directive `outname` and `plot_preserve_dir`
-----------------------------------------------------
+Plot Directive `outname` and `plot_cache_dir`
+---------------------------------------------
 
 The Sphinx plot directive can be used to automagically generate figures for
 documentation like so:
@@ -49,13 +49,13 @@ e.g. :file:`docfile3-4-01.png` or something equally mysterious. With
 easy to understand which output image is which and, more importantly, uniquely
 keys output images to code snippets.
 
-The ``plot_preserve_dir`` configuration value
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+The ``plot_cache_dir`` configuration value
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Setting the ``plot_preserve_dir`` configuration value to the name of a
+Setting the ``plot_cache_dir`` configuration value to the name of a
 directory will cause all images with ``:outname:`` set to be copied to this
 directory upon generation.
 
-If an image is already in ``plot_preserve_dir`` when documentation is being
+If an image is already in ``plot_cache_dir`` when documentation is being
 generated, this image is copied to the build directory thereby pre-empting
 generation and reducing computation time in low-resource environments.
@@ -145,7 +145,7 @@
     plot_template
         Provide a customized template for preparing restructured text.
 
-    plot_preserve_dir
+    plot_cache_dir
         Files with outnames are copied to this directory and files in this
         directory are copied back into the build directory prior to the build
         beginning.
@@ -300,7 +300,7 @@ def setup(app):
     app.add_config_value('plot_apply_rcparams', False, True)
     app.add_config_value('plot_working_directory', None, True)
     app.add_config_value('plot_template', None, True)
-    app.add_config_value('plot_preserve_dir',  '', True)
+    app.add_config_value('plot_cache_dir',  '', True)
     app.connect('doctree-read', mark_plot_labels)
     app.add_css_file('plot_directive.css')
     app.connect('build-finished', _copy_css_file)
@@ -635,12 +635,12 @@ def render_figures(code, code_path, output_dir, output_base, context,
             for fmt, dpi in formats:
                 try:
                     figman.canvas.figure.savefig(img.filename(fmt), dpi=dpi)
-                    if config.plot_preserve_dir and outname is not None:
+                    if config.plot_cache_dir and outname is not None:
                         _log.info(
                             "Preserving '{0}' into '{1}'".format(
-                                img.filename(fmt), config.plot_preserve_dir))
+                                img.filename(fmt), config.plot_cache_dir))
                         shutil.copy2(img.filename(fmt),
-                                     config.plot_preserve_dir)
+                                     config.plot_cache_dir)
                 except Exception as err:
                     raise PlotError(traceback.format_exc()) from err
                 img.formats.append(fmt)
@@ -686,10 +686,10 @@ def run(arguments, content, options, state_machine, state, lineno):
     else:
         _outname_list.add(outname)
 
-    if config.plot_preserve_dir:
+    if config.plot_cache_dir:
         # Ensure `preserve_dir` ends with a slash, otherwise `copy2`
         # will misbehave
-        config.plot_preserve_dir = os.path.join(config.plot_preserve_dir, '')
+        config.plot_cache_dir = os.path.join(config.plot_cache_dir, '')
 
     if len(arguments):
         if not config.plot_basedir:
@@ -803,9 +803,9 @@ def run(arguments, content, options, state_machine, state, lineno):
 
     # If we previously preserved copies of the generated figures this copies
     # them into the build directory so that they will not be remade.
-    if config.plot_preserve_dir and outname:
+    if config.plot_cache_dir and outname:
         outfiles = glob.glob(
-            os.path.join(config.plot_preserve_dir, outname) + '*')
+            os.path.join(config.plot_cache_dir, outname) + '*')
         for of in outfiles:
             _log.info("Copying preserved copy of '{0}' into '{1}'".format(
                 of, build_dir))