Various docstring fixes

pandas/core/frame.py

@@ -2610,10 +2610,10 @@ def transpose(self, *args, **kwargs):
 
         Parameters
         ----------
-        copy : bool, default False
-            If True, the underlying data is copied. Otherwise (default), no
-            copy is made if possible.
-        *args, **kwargs
+        *args
+            Additional arguments have no effect but might be accepted for
+            compatibility with numpy.
+        **kwargs
             Additional keywords have no effect but might be accepted for
             compatibility with numpy.
 
@@ -3237,7 +3237,7 @@ def eval(self, expr, inplace=False, **kwargs):
             If the expression contains an assignment, whether to perform the
             operation inplace and mutate the existing DataFrame. Otherwise,
             a new DataFrame is returned.
-        kwargs : dict
+        **kwargs : dict
             See the documentation for :func:`eval` for complete details
             on the keyword arguments accepted by
             :meth:`~pandas.DataFrame.query`.
@@ -5205,8 +5205,10 @@ def swaplevel(self, i=-2, j=-1, axis=0):
 
         Parameters
         ----------
-        i, j : int, str (can be mixed)
-            Level of index to be swapped. Can pass level name as string.
+        i : int, str (can be mixed)
+            Level of first index to be swapped. Can pass level name as string.
+        j : int, str (can be mixed)
+            Level of second index to be swapped. Can pass level name as string.
 
         Returns
         -------
@@ -6295,7 +6297,6 @@ def unstack(self, level=-1, fill_value=None):
     %(versionadded)s
     Parameters
     ----------
-    frame : DataFrame
     id_vars : tuple, list, or ndarray, optional
         Column(s) to use as identifier variables.
     value_vars : tuple, list, or ndarray, optional

pandas/core/series.py

@@ -2076,13 +2076,16 @@ def idxmin(self, axis=0, skipna=True, *args, **kwargs):
 
         Parameters
         ----------
-        skipna : bool, default True
-            Exclude NA/null values. If the entire Series is NA, the result
-            will be NA.
         axis : int, default 0
             For compatibility with DataFrame.idxmin. Redundant for application
             on Series.
-        *args, **kwargs
+        skipna : bool, default True
+            Exclude NA/null values. If the entire Series is NA, the result
+            will be NA.
+        *args
+            Additional arguments have no effect but might be accepted
+            for compatability with NumPy
+        **kwargs
             Additional keywords have no effect but might be accepted
             for compatibility with NumPy.
 
@@ -2146,13 +2149,16 @@ def idxmax(self, axis=0, skipna=True, *args, **kwargs):
 
         Parameters
         ----------
-        skipna : bool, default True
-            Exclude NA/null values. If the entire Series is NA, the result
-            will be NA.
         axis : int, default 0
             For compatibility with DataFrame.idxmax. Redundant for application
             on Series.
-        *args, **kwargs
+        skipna : bool, default True
+            Exclude NA/null values. If the entire Series is NA, the result
+            will be NA.
+        *args
+            Additional arguments have no effect but might be accepted
+            for compatibility with NumPy.
+        **kwargs
             Additional keywords have no effect but might be accepted
             for compatibility with NumPy.
 
@@ -3525,8 +3531,10 @@ def swaplevel(self, i=-2, j=-1, copy=True):
 
         Parameters
         ----------
-        i, j : int, str (can be mixed)
-            Level of index to be swapped. Can pass level name as string.
+        i : int, str
+            Level of first index to be swapped. Can pass level name as string.
+        j : int, str
+            Level of second index to be swapped. Can pass level name as string.
         copy : bool, default True
             Whether to copy underlying data.
 
@@ -4080,14 +4088,10 @@ def rename(self, index=None, **kwargs):
             the index.
             Scalar or hashable sequence-like will alter the ``Series.name``
             attribute.
-        copy : bool, default True
-            Whether to copy underlying data.
-        inplace : bool, default False
-            Whether to return a new Series. If True then value of copy is
-            ignored.
-        level : int or level name, default None
-            In case of a MultiIndex, only rename labels in the specified
-            level.
+
+        **kwargs
+            Additional keyword arguments passed to the function. Only the
+            "inplace" keyword is used.
 
         Returns
         -------
@@ -4165,6 +4169,10 @@ def drop(
         columns : single label or list-like
             No change is made to the Series; use 'index' or 'labels' instead.
 
+            .. versionadded:: 0.21.0
+        columns : None
+            Redundant for application on Series.
+
             .. versionadded:: 0.21.0
         level : int or level name, optional
             For MultiIndex, level for which the labels will be removed.

pandas/core/window/ewm.py

@@ -17,27 +17,10 @@
         ----------
         bias : bool, default False
             Use a standard estimation bias correction.
-        *args, **kwargs
-            Arguments and keyword arguments to be passed into func.
-"""
-
-_pairwise_template = """
-        Parameters
-        ----------
-        other : Series, DataFrame, or ndarray, optional
-            If not supplied then will default to self and produce pairwise
-            output.
-        pairwise : bool, default None
-            If False then only matching columns between self and other will be
-            used and the output will be a DataFrame.
-            If True then all pairwise combinations will be calculated and the
-            output will be a MultiIndex DataFrame in the case of DataFrame
-            inputs. In the case of missing elements, only complete pairwise
-            observations will be used.
-        bias : bool, default False
-           Use a standard estimation bias correction.
+        *args
+            Arguments to be passed into func.
         **kwargs
-           Keyword arguments to be passed into func.
+            Keyword arguments to be passed into func.
 """
 
 
@@ -275,8 +258,10 @@ def mean(self, *args, **kwargs):
 
         Parameters
         ----------
-        *args, **kwargs
-            Arguments and keyword arguments to be passed into func.
+        *args
+            Arguments to be passed into func.
+        **kwargs
+            Keyword arguments to be passed into func.
         """
         nv.validate_window_func("mean", args, kwargs)
         return self._apply("ewma", **kwargs)
@@ -317,10 +302,26 @@ def f(arg):
 
     @Substitution(name="ewm")
     @Appender(_doc_template)
-    @Appender(_pairwise_template)
     def cov(self, other=None, pairwise=None, bias=False, **kwargs):
         """
         Exponential weighted sample covariance.
+
+        Parameters
+        ----------
+        other : Series, DataFrame, or ndarray, optional
+            If not supplied then will default to self and produce pairwise
+            output.
+        pairwise : bool, default None
+            If False then only matching columns between self and other will be
+            used and the output will be a DataFrame.
+            If True then all pairwise combinations will be calculated and the
+            output will be a MultiIndex DataFrame in the case of DataFrame
+            inputs. In the case of missing elements, only complete pairwise
+            observations will be used.
+        bias : bool, default False
+            Use a standard estimation bias correction
+        **kwargs
+           Keyword arguments to be passed into func.
         """
         if other is None:
             other = self._selected_obj
@@ -348,11 +349,26 @@ def _get_cov(X, Y):
 
     @Substitution(name="ewm")
     @Appender(_doc_template)
-    @Appender(_pairwise_template)
     def corr(self, other=None, pairwise=None, **kwargs):
         """
         Exponential weighted sample correlation.
+
+        Parameters
+        ----------
+        other : Series, DataFrame, or ndarray, optional
+            If not supplied then will default to self and produce pairwise
+            output.
+        pairwise : bool, default None
+            If False then only matching columns between self and other will be
+            used and the output will be a DataFrame.
+            If True then all pairwise combinations will be calculated and the
+            output will be a MultiIndex DataFrame in the case of DataFrame
+            inputs. In the case of missing elements, only complete pairwise
+            observations will be used.
+        **kwargs : dict of {str : Any}
+           Keyword arguments to be passed into func.
         """
+
         if other is None:
             other = self._selected_obj
             # only default unset

pandas/core/window/rolling.py

@@ -495,7 +495,10 @@ def aggregate(self, func, *args, **kwargs):
 
     Parameters
     ----------
-    *args, **kwargs
+    *args
+        For compatibility with other %(name)s methods. Has no effect
+        on the computed value.
+    **kwargs
         For compatibility with other %(name)s methods. Has no effect
         on the computed value.
 
@@ -1018,7 +1021,9 @@ def count(self):
         not passed. In the future `raw` will default to False.
 
         .. versionadded:: 0.23.0
-    *args, **kwargs
+    args : tuple of Any
+        Arguments and keyword arguments to be passed into func.
+    kwargs : dict of {str : any}
         Arguments and keyword arguments to be passed into func.
 
     Returns
@@ -1084,7 +1089,9 @@ def sum(self, *args, **kwargs):
 
     Parameters
     ----------
-    *args, **kwargs
+    *args
+        Arguments and keyword arguments to be passed into func.
+    **kwargs
         Arguments and keyword arguments to be passed into func.
     """
     )
@@ -1190,7 +1197,9 @@ def median(self, **kwargs):
     ddof : int, default 1
         Delta Degrees of Freedom.  The divisor used in calculations
         is ``N - ddof``, where ``N`` represents the number of elements.
-    *args, **kwargs
+    *args
+        For NumPy compatibility. No additional arguments are used.
+    **kwargs
         For NumPy compatibility. No additional arguments are used.
 
     Returns
@@ -1265,7 +1274,9 @@ def f(arg, *args, **kwargs):
     ddof : int, default 1
         Delta Degrees of Freedom.  The divisor used in calculations
         is ``N - ddof``, where ``N`` represents the number of elements.
-    *args, **kwargs
+    *args
+        For NumPy compatibility. No additional arguments are used.
+    **kwargs
         For NumPy compatibility. No additional arguments are used.
 
     Returns
@@ -1392,7 +1403,7 @@ def kurt(self, **kwargs):
             * higher: `j`.
             * nearest: `i` or `j` whichever is nearest.
             * midpoint: (`i` + `j`) / 2.
-    **kwargs:
+    **kwargs
         For compatibility with other %(name)s methods. Has no effect on
         the result.
 

pandas/plotting/_misc.py

@@ -168,7 +168,7 @@ def radviz(frame, class_column, ax=None, color=None, colormap=None, **kwds):
     colormap : str or :class:`matplotlib.colors.Colormap`, default None
         Colormap to select colors from. If string, load colormap with that
         name from matplotlib.
-    kwds : optional
+    **kwds : optional
         Options to pass to matplotlib scatter plotting method.
 
     Returns
@@ -283,7 +283,7 @@ def bootstrap_plot(series, fig=None, size=50, samples=500, **kwds):
         greater or equal than the length of the `series`.
     samples : int, default 500
         Number of times the bootstrap procedure is performed.
-    **kwds :
+    **kwds
         Options to pass to matplotlib plotting method.
 
     Returns
@@ -398,7 +398,7 @@ def lag_plot(series, lag=1, ax=None, **kwds):
     series : Time series
     lag : lag of the scatter plot, default 1
     ax : Matplotlib axis object, optional
-    kwds : Matplotlib scatter method keyword arguments, optional
+    **kwds : Matplotlib scatter method keyword arguments, optional
 
     Returns
     -------