Merge pull request matplotlib#31644 from meeseeksmachine/auto-backport-of-pr-31579-on-v3.11.x

Backport PR matplotlib#31579 on branch v3.11.x (DOC: Document that bar() errorbars do not support individual coloring)

Author: rcomer

lib/matplotlib/axes/_axes.py

@@ -2409,11 +2409,16 @@ def bar(self, x, height, width=0.8, bottom=None, *, align="center",
               errors.
             - *None*: No errorbar. (Default)
 
-            See :doc:`/gallery/statistics/errorbar_features` for an example on
+            This is a convenience shortcut for an extra `~.axes.Axes.errorbar`
+            call. See its documentation and
+            :doc:`/gallery/statistics/errorbar_features` for an example on
             the usage of *xerr* and *yerr*.
 
         ecolor : :mpltype:`color` or list of :mpltype:`color`, default: 'black'
             The line color of the errorbars.
+            Multiple colors are only supported if the errorbars do not have
+            caps. If you need individually colored errorbars with caps, instead
+            use explicit `~.axes.Axes.errorbar` calls for each data point.
 
         capsize : float, default: :rc:`errorbar.capsize`
            The length of the error bar caps in points.