Merge pull request #10999 from jorisvandenbossche/doc-cat-nan

DOC: fix NaNs in categories

Author: jorisvandenbossche

doc/source/categorical.rst

@@ -149,8 +149,8 @@ Using ``.describe()`` on categorical data will produce similar output to a `Seri
 
 .. ipython:: python
 
-    cat = pd.Categorical(["a","c","c",np.nan], categories=["b","a","c",np.nan] )
-    df = pd.DataFrame({"cat":cat, "s":["a","c","c",np.nan]})
+    cat = pd.Categorical(["a", "c", "c", np.nan], categories=["b", "a", "c"])
+    df = pd.DataFrame({"cat":cat, "s":["a", "c", "c", np.nan]})
     df.describe()
     df["cat"].describe()
 
@@ -642,19 +642,18 @@ a code of ``-1``.
 
 .. ipython:: python
 
-    s = pd.Series(["a","b",np.nan,"a"], dtype="category")
+    s = pd.Series(["a", "b", np.nan, "a"], dtype="category")
     # only two categories
     s
-    s.codes
+    s.cat.codes
 
 
 Methods for working with missing data, e.g. :meth:`~Series.isnull`, :meth:`~Series.fillna`,
 :meth:`~Series.dropna`, all work normally:
 
 .. ipython:: python
 
-    c = pd.Series(["a","b",np.nan], dtype="category")
-    s = pd.Series(c)
+    s = pd.Series(["a", "b", np.nan], dtype="category")
     s
     pd.isnull(s)
     s.fillna("a")

doc/source/remote_data.rst

@@ -62,6 +62,7 @@ Yahoo! Finance
 --------------
 
 .. ipython:: python
+   :okwarning:
 
     import pandas.io.data as web
     import datetime

doc/source/timeseries.rst

@@ -1278,17 +1278,12 @@ frequency. Arithmetic is not allowed between ``Period`` with different ``freq``
 .. ipython:: python
 
    p = Period('2012', freq='A-DEC')
-
    p + 1
-
    p - 3
-
    p = Period('2012-01', freq='2M')
-
    p + 2
-
    p - 1
-
+   @okexcept
    p == Period('2012-01', freq='3M')
 
 

doc/source/visualization.rst

@@ -387,6 +387,7 @@ The existing interface ``DataFrame.boxplot`` to plot boxplot still can be used.
    np.random.seed(123456)
 
 .. ipython:: python
+   :okwarning:
 
    df = pd.DataFrame(np.random.rand(10,5))
    plt.figure();