Remove base

pandas/core/arrays/base.py

@@ -20,9 +20,9 @@ class ExtensionArray(object):
 
     **Restrictions on your class constructor**
 
-        * Your class should be able to be constructed with instances of
-          our class, i.e. ``ExtensionArray(extension_array)`` should returns
-          an instance.
+        * Extension arrays should be able to be constructed with instances of
+          the class, i.e. ``ExtensionArray(extension_array)`` should return
+          an instance, not error.
     """
     # ------------------------------------------------------------------------
     # Must be a Sequence
@@ -69,10 +69,6 @@ def __len__(self):
     # ------------------------------------------------------------------------
     # Required attributes
     # ------------------------------------------------------------------------
-    @property
-    def base(self):
-        """The base array I am a view of. None by default."""
-
     @property
     @abc.abstractmethod
     def dtype(self):
@@ -94,7 +90,11 @@ def ndim(self):
     @abc.abstractmethod
     def nbytes(self):
         # type: () -> int
-        """The number of bytes needed to store this object in memory."""
+        """The number of bytes needed to store this object in memory.
+
+        If this is expensive to compute, return an approximate lower bound
+        on the number of bytes needed.
+        """
 
     # ------------------------------------------------------------------------
     # Additional Methods
@@ -127,6 +127,8 @@ def take(self, indexer, allow_fill=True, fill_value=None):
         Notes
         -----
         This should follow pandas' semantics where -1 indicates missing values.
+        Positions where indexer is ``-1`` should be filled with the missing
+        value for this type.
 
         This is called by ``Series.__getitem__``, ``.loc``, ``iloc``, when the
         indexer is a sequence of values.

pandas/core/dtypes/base.py

@@ -94,8 +94,8 @@ def is_dtype(cls, dtype):
         -----
         The default implementation is True if
 
-        1. 'dtype' is a string that returns true for
-           ``cls.construct_from_string``
+        1. ``cls.construct_from_string(dtype)`` is an instance
+           of ``cls``.
         2. 'dtype' is ``cls`` or a subclass of ``cls``.
         """
         if isinstance(dtype, str):

pandas/core/internals.py

@@ -563,7 +563,7 @@ def _astype(self, dtype, copy=False, errors='raise', values=None,
 
         Returns
         -------
-        IntervalArray
+        Block
         """
         errors_legal_values = ('raise', 'ignore')