DOC: Fix docstring of window.Expanding/Rolling.apply and document *args and **kwargs

pandas/core/window.py

@@ -30,14 +30,15 @@
 
 _shared_docs = dict(**_shared_docs)
 _doc_template = """
-        Returns
-        -------
-        same type as input
 
-        See Also
-        --------
-        Series.%(name)s
-        DataFrame.%(name)s
+Returns
+-------
+same type as input
+
+See Also
+--------
+Series.%(name)s : Series %(name)s.
+DataFrame.%(name)s : DataFrame %(name)s.
 """
 
 
@@ -944,13 +945,13 @@ def count(self):
         return self._wrap_results(results, blocks, obj)
 
     _shared_docs['apply'] = dedent(r"""
-    %(name)s function apply.
+    The %(name)s function apply.
 
     Parameters
     ----------
     func : function
         Must produce a single value from an ndarray input if ``raw=True``
-        or a Series if ``raw=False``
+        or a Series if ``raw=False``.
     raw : bool, default None
         * ``False`` : passes each row or column as a Series to the
           function.
@@ -963,8 +964,8 @@ def count(self):
         not passed. In the future `raw` will default to False.
 
         .. versionadded:: 0.23.0
-
-    \*args and \*\*kwargs are passed to the function""")
+    *args, **kwargs :
+        Arguments and keyword arguments to be passed into func.""")
 
     def apply(self, func, raw=None, args=(), kwargs={}):
         from pandas import Series