Backport PR #23695: Document polar handling of _interpolation_steps.

timhoffm · meeseeksmachine · commit 7f152f40b549 · 2022-08-21T12:15:46.000Z
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,
