Small additional doc updates.

anntzer · anntzer · commit f28247a2f101 · 2021-07-20T21:09:17.000+02:00
diff --git a/doc/api/next_api_changes/behavior/XXXXX-AFV.rst b/doc/api/next_api_changes/behavior/XXXXX-AFV.rst
@@ -19,8 +19,7 @@ after instantiating a legend.
   leg.legendHandles[0].set_mec("black")  # marker edge color
 
 The former legend handler for Line2D objects has been renamed
-`.HandlerLine2DCompound`. To revert to the behavior that was used before
-Matplotlib 3, one can use
+`.HandlerLine2DCompound`. To revert to the previous behavior, one can use
 
 .. code::
 
diff --git a/lib/matplotlib/legend_handler.py b/lib/matplotlib/legend_handler.py
@@ -207,8 +207,9 @@ def get_ydata(self, legend, xdescent, ydescent, width, height, fontsize):
 class HandlerLine2DCompound(HandlerNpoints):
     """
     Original handler for `.Line2D` instances, that relies on combining
-    a line-only with a marker-only artist.
+    a line-only with a marker-only artist.  May be deprecated in the future.
     """
+
     def __init__(self, marker_pad=0.3, numpoints=None, **kwargs):
         """
         Parameters
@@ -257,12 +258,12 @@ class HandlerLine2D(HandlerNpoints):
     """
     Handler for `.Line2D` instances.
 
-    A class similar to the original handler for `.Line2D` instances but
-    that uses a monolithic artist rather than using one artist for the
-    line and another one for the marker(s).  NB: the former handler, in
-    use before Matplotlib 3, is still available as `.HandlerLine2DCompound`.
-
+    See Also
+    --------
+    HandlerLine2DCompound : An earlier handler implementation, which used one
+                            artist for the line and another for the marker(s).
     """
+
     def __init__(self, marker_pad=0.3, numpoints=None, **kw):
         """
         Parameters
