Fixed errors in doc string for Categorical + cleanup

Author: tp

pandas/core/categorical.py

@@ -199,18 +199,21 @@ class Categorical(PandasObject):
     >>> from pandas import Categorical
     >>> Categorical([1, 2, 3, 1, 2, 3])
     [1, 2, 3, 1, 2, 3]
-    Categories (3, int64): [1 < 2 < 3]
+    Categories (3, int64): [1, 2, 3]
 
     >>> Categorical(['a', 'b', 'c', 'a', 'b', 'c'])
     [a, b, c, a, b, c]
-    Categories (3, object): [a < b < c]
+    Categories (3, object): [a, b, c]
 
     Only ordered `Categoricals` can be sorted (according to the order
     of the categories) and have a min and max value.
 
-    >>> a = Categorical(['a','b','c','a','b','c'], ['c', 'b', 'a'],
-                        ordered=True)
-    >>> a.min()
+    >>> c = Categorical(['a','b','c','a','b','c'], categories=['c', 'b', 'a'],
+    ...                 ordered=True)
+    >>> c
+    [a, b, c, a, b, c]
+    Categories (3, object): [c < b < a]
+    >>> c.min()
     'c'
 
     Notes
@@ -219,11 +222,8 @@ class Categorical(PandasObject):
 
     See also
     --------
-    Categorical.sort
-    Categorical.order
-    Categorical.min
-    Categorical.max
     pandas.api.types.CategoricalDtype
+    CategoricalIndex : An Index with an underlying ``Categorical``
     """
 
     # For comparisons, so that numpy uses our implementation if the compare