matplotlib
diff --git a/Collapse file
‎doc/api/next_api_changes/2018-10-07-TH-deprecations.rst‎
Copy file name to clipboard
+9Lines changed: 9 additions & 0 deletions
Display the source diff
Display the rich diff b/Collapse file
‎doc/api/next_api_changes/2018-10-07-TH-deprecations.rst‎
Copy file name to clipboard
+9Lines changed: 9 additions & 0 deletions
Display the source diff
Display the rich diff
diff --git a/Collapse file
‎lib/mpl_toolkits/mplot3d/axes3d.py‎
Copy file name to clipboardExpand all lines: lib/mpl_toolkits/mplot3d/axes3d.py
+6Lines changed: 6 additions & 0 deletions b/Collapse file
‎lib/mpl_toolkits/mplot3d/axes3d.py‎
Copy file name to clipboardExpand all lines: lib/mpl_toolkits/mplot3d/axes3d.py
+6Lines changed: 6 additions & 0 deletions
@@ -0,0 +1,9 @@
+Deprecations
+````````````
+
+The following keyword arguments are deprecated:
+
+- Passing ``shade=None`` to
+  `~mpl_toolkits.mplot3d.axes3d.Axes3D.plot_surface` is deprecated. This was
+  an unintended implementation detail with the same semantics as
+  ``shade=False``. Please use the latter code instead.
@@ -1651,6 +1651,12 @@ def plot_surface(self, X, Y, Z, *args, norm=None, vmin=None,
 
         cmap = kwargs.get('cmap', None)
         shade = kwargs.pop('shade', cmap is None)
+        if shade is None:
+            cbook.warn_deprecated(
+                "3.1",
+                "Passing shade=None to Axes3D.plot_surface() is deprecated "
+                "since matplotlib 3.1 and will change its semantic or raise "
+                "an error in matplotlib 3.3. Please use shade=False instead.")
 
         # evenly spaced, and including both endpoints
         row_inds = list(range(0, rows-1, rstride)) + [rows-1]