DOC: minor doc formatting fixes

Author: jorisvandenbossche

pandas/core/frame.py

@@ -597,7 +597,7 @@ def iterrows(self):
         Notes
         -----
 
-        1. Because ``iterrows` returns a Series for each row,
+        1. Because ``iterrows`` returns a Series for each row,
            it does **not** preserve dtypes across the rows (dtypes are
            preserved across columns for DataFrames). For example,
 

pandas/core/series.py

@@ -333,7 +333,8 @@ def values(self):
         [a, a, b, c]
         Categories (3, object): [a, b, c]
 
-        # this is converted to UTC
+        Timezone aware datetime data is converted to UTC:
+
         >>> pd.Series(pd.date_range('20130101',periods=3,tz='US/Eastern')).values
         array(['2013-01-01T00:00:00.000000000-0500',
                '2013-01-02T00:00:00.000000000-0500',

pandas/tools/plotting.py

@@ -3674,10 +3674,10 @@ def box(self, by=None, **kwds):
         .. versionadded:: 0.17.0
 
         Parameters
-        ---------
+        ----------
         by : string or sequence
             Column in the DataFrame to group by.
-        **kwds : optional
+        \*\*kwds : optional
             Keyword arguments to pass on to :py:meth:`pandas.DataFrame.plot`.
 
         Returns