Merge pull request #15755 from meeseeksmachine/auto-backport-of-pr-15661-on-v3.2.x

timhoffm · web-flow · commit ecb5233ad5e5 · 2019-11-22T23:01:01.000+01:00
Backport PR #15661 on branch v3.2.x (Document scope of 3D scatter depthshading.)
diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -2251,7 +2251,8 @@ def scatter(self, xs, ys, zs=0, zdir='z', s=20, c=None, depthshade=True,
             For more details see the *c* argument of `~.axes.Axes.scatter`.
         depthshade : bool, optional, default: True
             Whether to shade the scatter markers to give the appearance of
-            depth.
+            depth. Each call to ``scatter()`` will perform its depthshading
+            independently.
         **kwargs
             All other arguments are passed on to `~.axes.Axes.scatter`.
 
