DOC : changes to histogram Returns doc section

tacaswell · tacaswell · commit 0a80ca6baf6d · 2014-06-29T16:36:27.000-04:00
- minor wording changes
 - pep8 cleanup
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -5388,16 +5388,21 @@ def hist(self, x, bins=10, range=None, normed=False, weights=None,
         Returns
         -------
         n : array or list of arrays
-            The values of the histogram. See **normed** and  **weights** for a
-            description of the possible semantics. If input **x** is an array, 
-            then this is an array of length **nbins**. If input is a sequence 
-            arrays ``[data1, data2,..]``, then this is a list of arrays with 
-            the values of the histograms for each of the arrays in the same 
-            order.
+            The values of the histogram bins. See **normed** and **weights**
+            for a description of the possible semantics. If input **x** is an
+            array, then this is an array of length **nbins**. If input is a
+            sequence arrays ``[data1, data2,..]``, then this is a list of
+            arrays with the values of the histograms for each of the arrays
+            in the same order.
+
         bins : array
-            The edges of the bins ``len(n)+1``.
+            The edges of the bins. Length nbins + 1 (nbins left edges and right
+            edge of last bin).  Always a single array even when multiple data
+            sets are passed in.
+
         patches : list or list of lists
-            Silent list of individual patches used to create the histogram.
+            Silent list of individual patches used to create the histogram
+            or list of such list if multiple input datasets.
 
         Other Parameters
         ----------------
