diff --git a/doc/users/dflt_style_changes.rst b/doc/users/dflt_style_changes.rst
index 3d06a27b5cb4..599c5ad13b79 100644
--- a/doc/users/dflt_style_changes.rst
+++ b/doc/users/dflt_style_changes.rst
@@ -416,6 +416,10 @@ By default, caps on the ends of errorbars are not present.
    demo(ax1, {'errorbar.capsize': 3}, 'classic')
    demo(ax2, {}, 'v2.0')
 
+This also changes the return value of
+:meth:`~matplotlib.axes.Axes.errorbar` as the list of 'caplines' will
+be empty by default.
+
 The previous defaults can be restored by setting::
 
     mpl.rcParams['errorbar.capsize'] = 3