DOC: doc building fixes

Author: jreback

doc/source/api.rst

@@ -47,22 +47,23 @@ Flat File IO
 
    read_table
    read_csv
+   read_fwf
+   read_clipboard
 
 .. currentmodule:: pandas.io.excel
 
 .. autosummary::
    :toctree: generated/
 
    read_excel
+   ExcelFile.parse
 
 .. currentmodule:: pandas.io.stata
 
 .. autosummary::
    :toctree: generated/
 
    read_stata
-   read_fwf
-   read_clipboard
 
 .. currentmodule:: pandas.io.html
 
@@ -83,15 +84,6 @@ SQL
 
    read_sql
 
-Excel IO
-^^^^^^^^
-.. currentmodule:: pandas.io.parsers
-
-.. autosummary::
-   :toctree: generated/
-
-   ExcelFile.parse
-
 SQL IO
 ^^^^^^
 .. currentmodule:: pandas.io.sql

doc/source/faq.rst

@@ -26,7 +26,7 @@ Frequently Asked Questions (FAQ)
 .. _ref-repr-control:
 
 How do I control the way my DataFrame is displayed?
--------------------------------------------
+---------------------------------------------------
 
 Pandas users rely on a variety of environments for using pandas: scripts, terminal,
 IPython qtconsole/ notebook, (IDLE, spyder, etc').

doc/source/io.rst

@@ -1052,7 +1052,7 @@ in the method ``to_string`` described above.
 .. note::
 
    Not all of the possible options for ``DataFrame.to_html`` are shown here for
-   brevity's sake. See :func:`~pandas.DataFrame.to_html` for the full set of
+   brevity's sake. See :func:`~pandas.core.frame.DataFrame.to_html` for the full set of
    options.
 
 .. ipython:: python

doc/source/v0.11.1.txt

@@ -90,7 +90,6 @@ API changes
     to be inserted if ``True``, default is ``False`` (same as prior to 0.11.1) (GH3679_)
   - Implement ``__nonzero__`` for ``NDFrame`` objects (GH3691_, GH3696_)
 
-
   - IO api
 
     - added top-level function ``read_excel`` to replace the following,
@@ -163,7 +162,7 @@ Enhancements
     .. ipython :: python
 
         df = DataFrame({'a': list('ab..'), 'b': [1, 2, 3, 4]})
-        df.replace(regex=r'\s*\.\s*', value=nan)
+        df.replace(regex=r'\s*\.\s*', value=np.nan)
 
     to replace all occurrences of the string ``'.'`` with zero or more
     instances of surrounding whitespace with ``NaN``.
@@ -172,7 +171,7 @@ Enhancements
 
     .. ipython :: python
 
-        df.replace('.', nan)
+        df.replace('.', np.nan)
 
     to replace all occurrences of the string ``'.'`` with ``NaN``.
 
@@ -257,24 +256,6 @@ Bug Fixes
     - Concat to produce a non-unique columns when duplicates are across dtypes is fixed (GH3602_)
     - Allow insert/delete to non-unique columns (GH3679_)
 
-    For example you can do
-
-    .. ipython :: python
-
-        df = DataFrame({'a': list('ab..'), 'b': [1, 2, 3, 4]})
-        df.replace(regex=r'\s*\.\s*', value=np.nan)
-
-    to replace all occurrences of the string ``'.'`` with zero or more
-    instances of surrounding whitespace with ``NaN``.
-
-    Regular string replacement still works as expected. For example, you can do
-
-    .. ipython :: python
-
-        df.replace('.', np.nan)
-
-    to replace all occurrences of the string ``'.'`` with ``NaN``.
-
   - ``DataFrame.from_records`` did not accept empty recarrays (GH3682_)
 
   - ``DataFrame.to_html`` and ``DataFrame.to_latex`` now accept a path for
@@ -322,3 +303,5 @@ on GitHub for a complete list.
 .. _GH3682: https://github.com/pydata/pandas/issues/3682
 .. _GH3679: https://github.com/pydata/pandas/issues/3679
 .. _GH3702: https://github.com/pydata/pandas/issues/3702
+.. _GH3691: https://github.com/pydata/pandas/issues/3691
+.. _GH3696: https://github.com/pydata/pandas/issues/3696

pandas/core/frame.py

@@ -1376,7 +1376,7 @@ def to_csv(self, path_or_buf, sep=",", na_rep='', float_format=None,
                tupleize_cols=True, **kwds):
         """
         Write DataFrame to a comma-separated values (csv) file
-
+        
         Parameters
         ----------
         path_or_buf : string or file handle / StringIO
@@ -1414,6 +1414,7 @@ def to_csv(self, path_or_buf, sep=",", na_rep='', float_format=None,
         tupleize_cols : boolean, default True
             write multi_index columns as a list of tuples (if True)
             or new (expanded format) if False)
+
         """
         if nanRep is not None:  # pragma: no cover
             import warnings
@@ -2421,6 +2422,7 @@ def lookup(self, row_labels, col_labels):
         Example
         -------
         values : ndarray
+
         """
         from itertools import izip
 
@@ -3475,7 +3477,8 @@ def bfill(self, axis=0, inplace=False, limit=None):
 
     def replace(self, to_replace=None, value=None, inplace=False, limit=None,
                 regex=False, infer_types=False, method=None, axis=None):
-        """Replace values given in 'to_replace' with 'value'.
+        """
+        Replace values given in 'to_replace' with 'value'.
 
         Parameters
         ----------
@@ -3561,6 +3564,7 @@ def replace(self, to_replace=None, value=None, inplace=False, limit=None,
           *are* strings, then you can do this.
         * This method has *a lot* of options. You are encouraged to experiment
           and play with this method to gain intuition about how it works.
+
         """
         if not isinstance(regex, bool) and to_replace is not None:
             raise AssertionError("'to_replace' must be 'None' if 'regex' is "