DOC: wording suggestions from review

Co-authored-by: hannah <[email protected]>
Co-authored-by: Tim Hoffmann <[email protected]>

Author: 3 people

doc/api/next_api_changes/deprecations/24538-OG.rst

@@ -1,5 +1,4 @@
 ``legend.legendHandles``
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
-... was undocumented and has been renamed to ``legend_handles``. Using the
-old name is deprecated.
+... was undocumented and has been renamed to ``legend_handles``. Using ``legendHandles`` is deprecated.

lib/matplotlib/legend.py

@@ -360,7 +360,7 @@ def __init__(
         labels : list of str
             A list of labels to show next to the artists. The length of handles
             and labels should be the same. If they are not, they are truncated
-            to the shortest of both lengths.
+            to the length of the shorter list.
 
         Other Parameters
         ----------------
@@ -369,7 +369,7 @@ def __init__(
         Attributes
         ----------
         legend_handles
-            A list of legend handles used by the legend.
+            List of `.Artists` added as legend entries. 
 
             .. versionadded:: 3.7
 

lib/matplotlib/legend_handler.py

@@ -18,7 +18,7 @@
 `.OffsetBox` instance. Within the call, you should create relevant
 artists (using relevant properties from the *legend* and/or
 *orig_handle*) and add them into the *handlebox*. The artists need to
-be scaled according to the *fontsize* (note that the size is in pixel,
+be scaled according to the *fontsize* (note that the size is in pixels,
 i.e., this is dpi-scaled value).
 
 This module includes definition of several legend handler classes
@@ -161,7 +161,8 @@ def create_artists(self, legend, orig_handle,
             The fontsize in pixels. The legend artists being created should
             be scaled according to the given fontsize.
         trans :  `~matplotlib.transforms.Transform`
-            The transform that is applied to the legend artists being created.
+            The transform that is applied to the legend artists being created.  Typically 
+            from unit coordinates in the handler box to screen coordinates.
         """
         raise NotImplementedError('Derived must override')
 
@@ -247,7 +248,7 @@ class HandlerLine2DCompound(HandlerNpoints):
     def create_artists(self, legend, orig_handle,
                        xdescent, ydescent, width, height, fontsize,
                        trans):
-        # Doc-string inherited
+        # docstring inherited
         xdata, xdata_marker = self.get_xdata(legend, xdescent, ydescent,
                                              width, height, fontsize)