Merge pull request pandas-dev#10189 from mortada/doc_fixes

DOC/CLN: period_range kwarg descriptions missing and other minor doc …

Author: jorisvandenbossche

pandas/core/groupby.py

@@ -187,7 +187,7 @@ class Grouper(object):
 
     Examples
     --------
-    >>> df.groupby(Grouper(key='A')) : syntatic sugar for df.groupby('A')
+    >>> df.groupby(Grouper(key='A')) : syntactic sugar for df.groupby('A')
     >>> df.groupby(Grouper(key='date',freq='60s')) : specify a resample on the column 'date'
     >>> df.groupby(Grouper(level='date',freq='60s',axis=1)) :
         specify a resample on the level 'date' on the columns axis with a frequency of 60s

pandas/tseries/period.py

@@ -110,20 +110,20 @@ class PeriodIndex(DatetimeIndexOpsMixin, Int64Index):
 
     Parameters
     ----------
-    data  : array-like (1-dimensional), optional
+    data : array-like (1-dimensional), optional
         Optional period-like data to construct index with
     dtype : NumPy dtype (default: i8)
-    copy  : bool
+    copy : bool
         Make a copy of input ndarray
     freq : string or period object, optional
         One of pandas period strings or corresponding objects
     start : starting value, period-like, optional
         If data is None, used as the start point in generating regular
         period data.
-    periods  : int, optional, > 0
+    periods : int, optional, > 0
         Number of periods to generate, if generating index. Takes precedence
         over end argument
-    end   : end value, period-like, optional
+    end : end value, period-like, optional
         If periods is none, generated index will extend to first conforming
         period on or just past end argument
     year : int, array, or Series, default None
@@ -501,7 +501,6 @@ def shift(self, n):
         ----------
         n : int
             Periods to shift by
-        freq : freq string
 
         Returns
         -------
@@ -970,8 +969,8 @@ def period_range(start=None, end=None, periods=None, freq='D', name=None):
 
     Parameters
     ----------
-    start :
-    end :
+    start : starting value, period-like, optional
+    end : ending value, period-like, optional
     periods : int, default None
         Number of periods in the index
     freq : str/DateOffset, default 'D'