DOC: some doc corrections

Author: jreback

doc/source/computation.rst

@@ -201,10 +201,12 @@ parameter:
 Window Functions
 ----------------
 
+.. currentmodule:: pandas.core.window
+
 .. warning::
 
    Prior to version 0.18.0, ``pd.rolling_*``, ``pd.expanding_*``, and ``pd.ewm*`` were module level
-   functions and are now deprecated and replaced by the corresponding method call.
+   functions and are now deprecated. These are replaced by using the :class:`~pandas.core.window.Rolling`, :class:`~pandas.core.window.Expanding` and :class:`~pandas.core.window.EWM`. objects and a corresponding method call.
 
    The deprecation warning will show the new syntax, see an example :ref:`here <whatsnew_0180.window_deprecations>`
    You can view the previous documentation
@@ -215,8 +217,6 @@ computing common *window* or *rolling* statistics. Among these are count, sum,
 mean, median, correlation, variance, covariance, standard deviation, skewness,
 and kurtosis.
 
-.. currentmodule:: pandas.core.window
-
 .. note::
 
    The API for window statistics is quite similar to the way one works with ``GroupBy`` objects, see the documentation :ref:`here <groupby>`
@@ -237,6 +237,14 @@ These are created from methods on ``Series`` and ``DataFrame``.
    r = s.rolling(window=60)
    r
 
+These object provide tab-completion of the avaible methods and properties.
+
+.. code-block:: python
+
+   In [14]: r.
+   r.agg         r.apply       r.count       r.exclusions  r.max         r.median      r.name        r.skew        r.sum
+   r.aggregate   r.corr        r.cov         r.kurt        r.mean        r.min         r.quantile    r.std         r.var
+
 Generally these methods all have the same interface. They all
 accept the following arguments:
 
@@ -390,7 +398,6 @@ Centering Windows
 
 By default the labels are set to the right edge of the window, but a
 ``center`` keyword is available so the labels can be set at the center.
-This keyword is available in other rolling functions as well.
 
 .. ipython:: python
 

doc/source/whatsnew/v0.18.0.txt

@@ -13,7 +13,7 @@ users upgrade to this version.
 
 Highlights include:
 
-- Window functions are now methods on ``.groupby`` like objects, see :ref:`here <whatsnew_0180.moments>`.
+- Window functions are now methods on ``.groupby`` like objects, see :ref:`here <whatsnew_0180.enhancements.moments>`.
 
 Check the :ref:`API Changes <whatsnew_0180.api>` and :ref:`deprecations <whatsnew_0180.deprecations>` before updating.
 
@@ -45,6 +45,8 @@ Previous Behavior:
 .. code-block:: python
 
    In [8]: pd.rolling_mean(df,window=3)
+           FutureWarning: pd.rolling_mean is deprecated for DataFrame and will be removed in a future version, replace with
+                          DataFrame.rolling(window=3,center=False).mean()
    Out[8]:
        A         B
    0 NaN       NaN
@@ -64,13 +66,20 @@ New Behavior:
 
    r = df.rolling(window=3)
 
-These show a descriptive repr, with tab-completion of available methods
+These show a descriptive repr
 
 .. ipython:: python
 
    r
+with tab-completion of available methods and properties.
 
-The methods operate on this ``Rolling`` object itself
+.. code-block:: python
+
+   In [9]: r.
+   r.A           r.agg         r.apply       r.count       r.exclusions  r.max         r.median      r.name        r.skew        r.sum
+   r.B           r.aggregate   r.corr        r.cov         r.kurt        r.mean        r.min         r.quantile    r.std         r.var
+
+The methods operate on the ``Rolling`` object itself
 
 .. ipython:: python