Add note on wrapping

dstansby · dstansby · commit 592df369c1f5 · 2020-02-13T18:13:11.000Z
diff --git a/lib/matplotlib/projections/polar.py b/lib/matplotlib/projections/polar.py
@@ -1007,7 +1007,7 @@ def get_thetamin(self):
         return np.rad2deg(self.viewLim.xmin)
 
     def set_thetalim(self, *args, **kwargs):
-        """
+        r"""
         Set the minimum and maximum theta values.
 
         Can take the following signatures:
@@ -1016,7 +1016,10 @@ def set_thetalim(self, *args, **kwargs):
         - ``set_thetalim(thetamin=minval, thetamax=maxval)``: Set the limits
           in degrees.
 
-        where minval and maxval are the minimum and maximum limits.
+        where minval and maxval are the minimum and maximum limits. Values are
+        wrapped in to the range :math:`[0, 2\pi]` (in radians), so for example
+        it is possible to do ``set_thetalim(-np.pi / 2, np.pi / 2)`` to have
+        an axes symmetric around 0.
         """
         if 'thetamin' in kwargs:
             kwargs['xmin'] = np.deg2rad(kwargs.pop('thetamin'))
