DOC/PLT: Add stacked in doc and doc example for barh and bar plot

pandas/plotting/_core.py

@@ -954,6 +954,9 @@ def line(self, x=None, y=None, **kwargs):
 
     @Appender(
         """
+        stacked: bool, default is False
+            If stacked is set to True, stacked bar charts will be plotted.
+
         See Also
         --------
         DataFrame.plot.barh : Horizontal bar plot.
@@ -985,6 +988,13 @@ def line(self, x=None, y=None, **kwargs):
             ...                    'lifespan': lifespan}, index=index)
             >>> ax = df.plot.bar(rot=0)
 
+        Plot stacked bar chars for the DataFrame
+
+        .. plot::
+            :context: close-figs
+
+            >>> ax = df.plot.bar(stacked=True)
+
         Instead of nesting, the figure can be split by column with
         ``subplots=True``. In this case, a :class:`numpy.ndarray` of
         :class:`matplotlib.axes.Axes` are returned.
@@ -1037,6 +1047,9 @@ def bar(self, x=None, y=None, **kwargs):
 
     @Appender(
         """
+        stacked: bool, default is False
+            If stacked is set to True, stacked horizontal bar charts will be plotted.
+
         See Also
         --------
         DataFrame.plot.bar: Vertical bar plot.
@@ -1066,6 +1079,13 @@ def bar(self, x=None, y=None, **kwargs):
             ...                    'lifespan': lifespan}, index=index)
             >>> ax = df.plot.barh()
 
+        Plot stacked bar chars for the DataFrame
+
+        .. plot::
+            :context: close-figs
+
+            >>> ax = df.plot.bar(stacked=True)
+
         We can specify colors for each column
 
         .. plot::