DOC: minor tweaks to the wording

tacaswell · tacaswell · commit c0ee6316f68f · 2020-04-27T18:23:16.000-04:00
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -2944,10 +2944,13 @@ def pie(self, x, explode=None, labels=None, colors=None,
 
         normalize: None or bool, default: None
             When *True*, always make a full pie by normalizing x so that
-            ``sum(x) == 1``. When *False*, make a partial pie.
-            When *None*, gives the current behavior and warns if
-            ``sum(x) < 1``. Please note that passing None to this parameter is
-            deprecated.
+            ``sum(x) == 1``. When *False*, make a partial (or overfull) pie.
+
+            When *None*, gives the normalize if ``sum(x) > 0`` and warn if
+            ``sum(x) < 1``.
+
+            Please note that passing None to this parameter is deprecated.
+
             ``pie()`` used to draw a partial pie if ``sum(x) < 1``. This
             behavior is deprecated and will change to always normalizing the
             values to a full pie by default. If you want to draw a partial pie,
