Merge remote-tracking branch 'matplotlib/v2.2.2-doc' into v2.2.x

tacaswell · tacaswell · commit 78258c1c30bf · 2018-08-04T21:50:14.000-04:00
diff --git a/examples/lines_bars_and_markers/stem_plot.py b/examples/lines_bars_and_markers/stem_plot.py
@@ -3,13 +3,23 @@
 Stem Plot
 =========
 
-Example stem plot.
+Stem plot plots vertical lines from baseline to the y-coordinate
+Plotting cosine(x) w.r.t x, using '-.' as the pattern
+for plotting vertical lines
 """
 import matplotlib.pyplot as plt
 import numpy as np
 
+# returns 10 evenly spaced samples from 0.1 to 2*PI
 x = np.linspace(0.1, 2 * np.pi, 10)
+
 markerline, stemlines, baseline = plt.stem(x, np.cos(x), '-.')
+
+# setting property of baseline with color red and linewidth 2
 plt.setp(baseline, color='r', linewidth=2)
 
 plt.show()
+
+#############################
+# This example makes use of:
+# * :meth:`matplotlib.axes.Axes.stem`
