Merge pull request matplotlib#27947 from thehappycheese/main

Update docs for `FancyArrowPatch` & `Annotation` to make it clear that ShinkA/B parameters are in points and not fractional.

Author: timhoffm

lib/matplotlib/patches.py

@@ -4189,7 +4189,7 @@ def __init__(self, posA=None, posB=None, *,
             Head and tail patches, respectively.
 
         shrinkA, shrinkB : float, default: 2
-            Shrinking factor of the tail and head of the arrow respectively.
+            Shrink amount, in points, of the tail and head of the arrow respectively.
 
         mutation_scale : float, default: 1
             Value with which attributes of *arrowstyle* (e.g., *head_length*)

lib/matplotlib/text.py

@@ -1767,8 +1767,8 @@ def transform(renderer) -> Transform
             relpos           See below; default is (0.5, 0.5)
             patchA           Default is bounding box of the text
             patchB           Default is None
-            shrinkA          Default is 2 points
-            shrinkB          Default is 2 points
+            shrinkA          In points. Default is 2 points
+            shrinkB          In points. Default is 2 points
             mutation_scale   Default is text size (in points)
             mutation_aspect  Default is 1
             ?                Any `.FancyArrowPatch` property