Merge pull request #15754 from meeseeksmachine/auto-backport-of-pr-15661-on-v3.1.1-doc

timhoffm · web-flow · commit d10da59333f4 · 2019-11-22T23:01:08.000+01:00
Backport PR #15661 on branch v3.1.1-doc (Document scope of 3D scatter depthshading.)
diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -2339,7 +2339,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`.
 
