DOC: clearify and simplify docstring

tacaswell · tacaswell · commit 7cde8deb7bc3 · 2020-06-03T22:17:53.000-04:00
diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -362,15 +362,11 @@ def set_box_aspect(self, aspect, *, zoom=1):
 
         Parameters
         ----------
-        aspect : 3-tuple of floats on None
-            Changes the physical dimensions of the Axes, such that the ratio
-            of the size of the axis in physical units is x:y:z
+        aspect : 3-tuple of floats or None
+            Changes the physical dimensions of the Axes3D, such that the ratio
+            of the axis lengths in physical units is x:y:z.
 
-            The input will be normalized to a unit vector.
-
-            If None, it is approximately ::
-
-                ax.set_box_aspect(aspect=(4, 4, 3), zoom=1)
+            If None, defaults to 4:4:3
 
         zoom : float
             Control overall size of the Axes3D in the figure.
