Minor updates from suggestions.

jacoverster · web-flow · commit ad012932b0f5 · 2022-10-21T08:46:46.000+02:00
diff --git a/examples/text_labels_and_annotations/angles_on_bracket_arrows.py b/examples/text_labels_and_annotations/angles_on_bracket_arrows.py
@@ -169,7 +169,7 @@ def R(a, r, w, h):
 
 
 #############################################################################
-# The plot is generatd with the following code.
+# The plot is generated with the following code.
 
 def get_point_of_rotated_vertical(origin, line_length, degrees):
     """Return xy coordinates of the vertical line end rotated by degrees."""
@@ -180,7 +180,9 @@ def get_point_of_rotated_vertical(origin, line_length, degrees):
 
 fig, ax = plt.subplots(figsize=(8, 7))
 ax.set(xlim=(0, 6), ylim=(-1, 4))
-ax.set_title('Angle annotations on bracket arrows')
+ax.set_title(
+    'Orientation of the bracket (arrow head/tail) relative to angleA and angleB'
+)
 
 for i, stylename in enumerate(["]-[", "|-|"]):
     for j, angle in enumerate([-40, 60]):
diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
@@ -3122,6 +3122,10 @@ class ArrowStyle(_Style):
 
     Notes
     -----
+    *angleA* and *angleB* specify the orientation of the bracket, as either a clockwise
+    or counterclockwise angle depending on the arrow type. 0 degrees means perpendicular
+    to the line connecting the arrow's head and tail.
+
     .. plot:: gallery/text_labels_and_annotations/angles_on_bracket_arrows.py
     """
 
