DOC: Clarify note in get_path_collection_extents

QuLogic · QuLogic · commit 4ac83284a849 · 2023-03-18T04:31:03.000-04:00
I found it confusing that it was listing A, A, A, A... a bunch of times.
Also, add an initial line for short docs.
diff --git a/lib/matplotlib/path.py b/lib/matplotlib/path.py
@@ -1042,9 +1042,10 @@ def clip_to_bbox(self, bbox, inside=True):
 def get_path_collection_extents(
         master_transform, paths, transforms, offsets, offset_transform):
     r"""
-    Given a sequence of `Path`\s, `.Transform`\s objects, and offsets, as
-    found in a `.PathCollection`, returns the bounding box that encapsulates
-    all of them.
+    Get bounding box of a `.PathCollection`\s internal objects.
+
+    That is, given a sequence of `Path`\s, `.Transform`\s objects, and offsets, as found
+    in a `.PathCollection`, return the bounding box that encapsulates all of them.
 
     Parameters
     ----------
@@ -1058,12 +1059,14 @@ def get_path_collection_extents(
 
     Notes
     -----
-    The way that *paths*, *transforms* and *offsets* are combined
-    follows the same method as for collections:  Each is iterated over
-    independently, so if you have 3 paths, 2 transforms and 1 offset,
-    their combinations are as follows:
-
-        (A, A, A), (B, B, A), (C, A, A)
+    The way that *paths*, *transforms* and *offsets* are combined follows the same
+    method as for collections: each is iterated over independently, so if you have 3
+    paths (A, B, C), 2 transforms (α, β) and 1 offset (O), their combinations are as
+    follows:
+
+    - (A, α, O)
+    - (B, β, O)
+    - (C, α, O)
     """
     from .transforms import Bbox
     if len(paths) == 0:
