DOC: add some See Also to Categorical

Author: jreback

doc/source/api.rst

@@ -653,13 +653,21 @@ adding ordering information or special categories is need at creation time of th
    Categorical.from_codes
 
 ``np.asarray(categorical)`` works by implementing the array interface. Be aware, that this converts
-the Categorical back to a numpy array, so levels and order information is not preserved!
+the Categorical back to a numpy array, so categories and order information is not preserved!
 
 .. autosummary::
    :toctree: generated/
 
    Categorical.__array__
 
+Categorical methods
+
+.. autosummary::
+   :toctree: generated/
+
+   Categorical.unique
+   Categorical.value_counts
+
 Plotting
 ~~~~~~~~
 

pandas/core/algorithms.py

@@ -287,7 +287,7 @@ def unique(values):
 
     Examples
     --------
-    pd.unique(pd.Series([2, 1, 3, 3]))
+    >>> pd.unique(pd.Series([2, 1, 3, 3]))
     array([2, 1, 3])
 
     >>> pd.unique(pd.Series([2] + [1] * 5))

pandas/core/categorical.py

@@ -1137,8 +1137,9 @@ def isnull(self):
 
         See also
         --------
-        pandas.isnull : pandas version
+        isnull : pandas version
         Categorical.notnull : boolean inverse of Categorical.isnull
+
         """
 
         ret = self._codes == -1
@@ -1164,8 +1165,9 @@ def notnull(self):
 
         See also
         --------
-        pandas.notnull : pandas version
+        notnull : pandas version
         Categorical.isnull : boolean inverse of Categorical.notnull
+
         """
         return ~self.isnull()
 
@@ -1206,6 +1208,11 @@ def value_counts(self, dropna=True):
         Returns
         -------
         counts : Series
+
+        See Also
+        --------
+        Series.value_counts
+
         """
         from numpy import bincount
         from pandas.types.missing import isnull
@@ -1308,6 +1315,7 @@ def sort_values(self, inplace=False, ascending=True, na_position='last'):
         See Also
         --------
         Categorical.sort
+        Series.sort_values
 
         Examples
         --------
@@ -1919,8 +1927,9 @@ def unique(self):
 
         See Also
         --------
-        pandas.unique
-        pandas.CategoricalIndex.unique
+        unique
+        CategoricalIndex.unique
+        Series.unique
 
         """