Add note to errobar

dstansby · dstansby · commit 029fe210fed5 · 2017-07-03T21:31:35.000+01:00
diff --git a/doc/api/api_changes/2017-07-03-DS-logscale_masked.rst b/doc/api/api_changes/2017-07-03-DS-logscale_masked.rst
@@ -1,8 +1,8 @@
 Default behavior of log scales changed to mask <= 0 values
 ``````````````````````````````````````````````````````````
 
-Calling `matplotlib.Axes.set_xscale` or `matplotlib.Axes.set_yscale` now uses
-'mask' as the default method to handle invalid values (as opposed to 'clip').
-This means that any values <= 0 on a log scale will not be shown.
+Calling `matplotlib.axes.Axes.set_xscale` or `matplotlib.axes.Axes.set_yscale`
+now uses 'mask' as the default method to handle invalid values (as opposed to
+'clip'). This means that any values <= 0 on a log scale will not be shown.
 
 Previously they were clipped to a very small number and shown.
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -2751,6 +2751,10 @@ def errorbar(self, x, y, yerr=None, xerr=None,
 
             %(Line2D)s
 
+        Notes
+        -----
+        Error bars with negative values will not be shown when plotted on a
+        logarithmic axis.
         """
         kwargs = cbook.normalize_kwargs(kwargs, _alias_map)
         # anything that comes in as 'None', drop so the default thing
