Merge pull request matplotlib#28801 from timhoffm/axline-set_xy2

timhoffm · web-flow · commit e27961def628 · 2024-09-11T13:45:15.000+02:00
DOC: Clarify AxLine.set_xy2 / AxLine.set_slope
diff --git a/lib/matplotlib/lines.py b/lib/matplotlib/lines.py
@@ -1568,6 +1568,12 @@ def set_xy2(self, x, y):
         """
         Set the *xy2* value of the line.
 
+        .. note::
+
+            You can only set *xy2* if the line was created using the *xy2*
+            parameter. If the line was created using *slope*, please use
+            `~.AxLine.set_slope`.
+
         Parameters
         ----------
         x, y : float
@@ -1583,6 +1589,12 @@ def set_slope(self, slope):
         """
         Set the *slope* value of the line.
 
+        .. note::
+
+            You can only set *slope* if the line was created using the *slope*
+            parameter. If the line was created using *xy2*, please use
+            `~.AxLine.set_xy2`.
+
         Parameters
         ----------
         slope : float
