Clarify how to get data from Line3D and fix formatting issue

oscargus · oscargus · commit 0ecb0a2310b9 · 2023-06-19T12:44:43.000+02:00
diff --git a/lib/mpl_toolkits/mplot3d/art3d.py b/lib/mpl_toolkits/mplot3d/art3d.py
@@ -183,6 +183,10 @@ def text_2d_to_3d(obj, z=0, zdir='z'):
 class Line3D(lines.Line2D):
     """
     3D line object.
+
+    .. note:: Use `get_data_3d` to obtain the data associated with the line.
+            `~.Line2D.get_xdata` and `~.Line2D.get_ydata` will return the x- and
+            y-coodinates of the projected line, not the x- and y-data of the 3D-line.
     """
 
     def __init__(self, xs, ys, zs, *args, **kwargs):
@@ -196,8 +200,8 @@ def __init__(self, xs, ys, zs, *args, **kwargs):
             The y-data to be plotted.
         zs : array-like
             The z-data to be plotted.
-
-        Additional arguments are passed onto :func:`~matplotlib.lines.Line2D`.
+        *args, **kwargs :
+            Additional arguments are passed to `~matplotlib.lines.Line2D`.
         """
         super().__init__([], [], *args, **kwargs)
         self.set_data_3d(xs, ys, zs)
