Add example docstrings

tonysyu · tonysyu · commit 6d1b8a2ef277 · 2013-09-29T11:40:04.000-05:00
diff --git a/examples/pylab_examples/histogram_demo_cumulative.py b/examples/pylab_examples/histogram_demo_cumulative.py
@@ -1,3 +1,7 @@
+"""
+Demo of the histogram (hist) function used to plot a cumulative distribution.
+
+"""
 import numpy as np
 import matplotlib.pyplot as plt
 from matplotlib import mlab
@@ -16,7 +20,7 @@
 y /= y[-1]
 plt.plot(bins, y, 'k--', linewidth=1.5)
 
-# Overlay a reverted cumulative histogram.
+# Overlay a reversed cumulative histogram.
 plt.hist(x, bins=bins, normed=1, histtype='step', cumulative=-1)
 
 plt.grid(True)
diff --git a/examples/pylab_examples/histogram_demo_histtypes.py b/examples/pylab_examples/histogram_demo_histtypes.py
@@ -1,3 +1,10 @@
+"""
+Demo of the histogram (hist) function with different ``histtype`` settings.
+
+* Histogram with step curve that has a color fill.
+* Histogram with with unequal bin widths.
+
+"""
 import numpy as np
 import matplotlib.pyplot as plt
 from matplotlib import mlab
diff --git a/examples/pylab_examples/histogram_demo_multihist.py b/examples/pylab_examples/histogram_demo_multihist.py
@@ -1,3 +1,13 @@
+"""
+Demo of the histogram (hist) function with multiple data sets.
+
+Plot histogram with multiple sample sets and demonstrate:
+
+    * Use of legend with multiple sample sets
+    * Stacked bars
+    * Step curve with a color fill
+    * Data sets of different sample sizes
+"""
 import numpy as np
 import matplotlib.pyplot as plt
 
