RF: always close figures before plot directive

If we don't close figures, the plot directive can easily pick up figures
from previous plot directives.

Author: matthew-brett

doc/source/coordinate_systems.rst

@@ -60,13 +60,6 @@ the array.
 We collected an anatomical image in the same session.  We can load that image
 and look at slices in the three axes:
 
-.. plot::
-    :nofigs:
-    :include-source: false
-
-    # This guy just closes the previous figure so we don't get it twice
-    plt.close('all')
-
 .. plot::
     :context:
 

doc/sphinxext/plot_directive.py

@@ -601,7 +601,9 @@ def render_figures(code, code_path, output_dir, output_base, context,
     for i, code_piece in enumerate(code_pieces):
 
         if not context or config.plot_apply_rcparams:
-            clear_state(config.plot_rcparams, close=not context)
+            clear_state(config.plot_rcparams)
+        else:
+            plt.close('all')
 
         run_code(code_piece, code_path, ns, function_name)