Merge pull request #25503 from meeseeksmachine/auto-backport-of-pr-25495-on-v3.7.x

oscargus · web-flow · commit 9e427784e9f8 · 2023-03-19T21:03:44.000+01:00
Backport PR #25495 on branch v3.7.x (DOC: Clarify note in get_path_collection_extents)
diff --git a/lib/matplotlib/path.py b/lib/matplotlib/path.py
@@ -1048,9 +1048,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
     ----------
@@ -1064,12 +1065,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:
