Merge pull request #23696 from meeseeksmachine/auto-backport-of-pr-23695-on-v3.6.x

QuLogic · web-flow · commit 04b1be5a1de0 · 2022-08-22T18:52:10.000-04:00
Backport PR #23695 on branch v3.6.x (Document polar handling of _interpolation_steps.)
diff --git a/lib/matplotlib/projections/polar.py b/lib/matplotlib/projections/polar.py
@@ -17,11 +17,16 @@
 
 class PolarTransform(mtransforms.Transform):
     """
-    The base polar transform.  This handles projection *theta* and
-    *r* into Cartesian coordinate space *x* and *y*, but does not
-    perform the ultimate affine transformation into the correct
-    position.
+    The base polar transform.
+
+    This transform maps polar coordinates ``(theta, r)`` into Cartesian
+    coordinates ``(x, y) = (r * cos(theta), r * sin(theta))`` (but does not
+    handle positioning in screen space).
+
+    Path segments at a fixed radius are automatically transformed to circular
+    arcs as long as ``path._interpolation_steps > 1``.
     """
+
     input_dims = output_dims = 2
 
     def __init__(self, axis=None, use_rmin=True,
