DOCS: edits to warnings fixes from @timhoffm

brunobeltran · brunobeltran · commit b705e02031cc · 2020-11-08T19:07:40.000-08:00
diff --git a/doc/conf.py b/doc/conf.py
@@ -166,7 +166,6 @@ def _check_dependencies():
     'thumbnail_size': (320, 224),
     'compress_images': ('thumbnails', 'images'),
     'matplotlib_animations': True,
-    'abort_on_example_error': True,
 }
 
 plot_gallery = 'True'
diff --git a/examples/images_contours_and_fields/contourf_demo.py b/examples/images_contours_and_fields/contourf_demo.py
@@ -5,8 +5,6 @@
 
 How to use the `.axes.Axes.contourf` method to create filled contour plots.
 """
-import copy
-
 import numpy as np
 import matplotlib.pyplot as plt
 
@@ -89,10 +87,7 @@
 # Illustrate all 4 possible "extend" settings:
 extends = ["neither", "both", "min", "max"]
 cmap = plt.cm.get_cmap("winter")
-# we need a copy of the colormap to modify it
-cmap = copy.copy(cmap)
-cmap.set_under("magenta")
-cmap.set_over("yellow")
+cmap = cmap.with_extremes(under="magenta", over="yellow")
 # Note: contouring simply excludes masked or nan regions, so
 # instead of using the "bad" colormap value for them, it draws
 # nothing at all in them.  Therefore the following would have
diff --git a/examples/subplots_axes_and_figures/secondary_axis.py b/examples/subplots_axes_and_figures/secondary_axis.py
@@ -57,7 +57,8 @@ def rad2deg(x):
 ax.set_title('Random spectrum')
 
 
-def safe_inverse(x):
+def one_over(x):
+    """Vectorized 1/x, treating x==0 manually"""
     x = np.array(x).astype(float)
     near_zero = np.isclose(x, 0)
     x[near_zero] = np.inf
@@ -66,10 +67,10 @@ def safe_inverse(x):
 
 
 # the function "1/x" is its own inverse
-forward = safe_inverse
+inverse = one_over
 
 
-secax = ax.secondary_xaxis('top', functions=(forward, safe_inverse))
+secax = ax.secondary_xaxis('top', functions=(one_over, inverse))
 secax.set_xlabel('period [s]')
 plt.show()
 
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -524,12 +524,14 @@ def secondary_xaxis(self, location, *, functions=None, **kwargs):
             ax.set_xlabel('frequency [Hz]')
 
             def invert(x):
+                # 1/x with special treatment of x == 0
                 x = np.array(x).astype(float)
                 near_zero = np.isclose(x, 0)
                 x[near_zero] = np.inf
                 x[~near_zero] = 1 / x[~near_zero]
                 return x
 
+            # the inverse of 1/x is itself
             secax = ax.secondary_xaxis('top', functions=(invert, invert))
             secax.set_xlabel('Period [s]')
             plt.show()
diff --git a/tutorials/intermediate/tight_layout_guide.py b/tutorials/intermediate/tight_layout_guide.py
@@ -205,7 +205,7 @@ def example_plot(ax, fontsize=12):
 # complicated layouts, like having one GridSpec in the left and one in the
 # right side of the figure. For these use cases, one should instead take
 # advantage of :doc:`/gallery/subplots_axes_and_figures/gridspec_nested`, or
-# the :doc:`/users/next_whats_new/subfigures`.
+# the :doc:`/gallery/subplots_axes_and_figures/subfigures`.
 
 
 ###############################################################################

Original file line number	Diff line number	Diff line change
`@@ -166,7 +166,6 @@ def _check_dependencies():`
`166`	`166`	`'thumbnail_size': (320, 224),`
`167`	`167`	`'compress_images': ('thumbnails', 'images'),`
`168`	`168`	`'matplotlib_animations': True,`
`169`		`- 'abort_on_example_error': True,`
`170`	`169`	`}`
`171`	`170`
`172`	`171`	`plot_gallery = 'True'`