Revert "Capitalizing first letter of doc in pandas.Series"

This reverts commit 95a6ac2.

Author: Alex Volkov

pandas/core/base.py

@@ -668,7 +668,7 @@ class IndexOpsMixin(object):
     __array_priority__ = 1000
 
     def transpose(self, *args, **kwargs):
-        """ Return the transpose, which is by definition self """
+        """ return the transpose, which is by definition self """
         nv.validate_transpose(args, kwargs)
         return self
 
@@ -692,18 +692,18 @@ def _is_homogeneous_type(self):
 
     @property
     def shape(self):
-        """ Return a tuple of the shape of the underlying data """
+        """ return a tuple of the shape of the underlying data """
         return self._values.shape
 
     @property
     def ndim(self):
-        """ Return the number of dimensions of the underlying data,
+        """ return the number of dimensions of the underlying data,
         by definition 1
         """
         return 1
 
     def item(self):
-        """ Return the first element of the underlying data as a python
+        """ return the first element of the underlying data as a python
         scalar
         """
         try:
@@ -715,49 +715,49 @@ def item(self):
 
     @property
     def data(self):
-        """ Return the data pointer of the underlying data """
+        """ return the data pointer of the underlying data """
         warnings.warn("{obj}.data is deprecated and will be removed "
                       "in a future version".format(obj=type(self).__name__),
                       FutureWarning, stacklevel=2)
         return self.values.data
 
     @property
     def itemsize(self):
-        """ Return the size of the dtype of the item of the underlying data """
+        """ return the size of the dtype of the item of the underlying data """
         warnings.warn("{obj}.itemsize is deprecated and will be removed "
                       "in a future version".format(obj=type(self).__name__),
                       FutureWarning, stacklevel=2)
         return self._ndarray_values.itemsize
 
     @property
     def nbytes(self):
-        """ Return the number of bytes in the underlying data """
+        """ return the number of bytes in the underlying data """
         return self._values.nbytes
 
     @property
     def strides(self):
-        """ Return the strides of the underlying data """
+        """ return the strides of the underlying data """
         warnings.warn("{obj}.strides is deprecated and will be removed "
                       "in a future version".format(obj=type(self).__name__),
                       FutureWarning, stacklevel=2)
         return self._ndarray_values.strides
 
     @property
     def size(self):
-        """ Return the number of elements in the underlying data """
+        """ return the number of elements in the underlying data """
         return self._values.size
 
     @property
     def flags(self):
-        """ Return the ndarray.flags for the underlying data """
+        """ return the ndarray.flags for the underlying data """
         warnings.warn("{obj}.flags is deprecated and will be removed "
                       "in a future version".format(obj=type(self).__name__),
                       FutureWarning, stacklevel=2)
         return self.values.flags
 
     @property
     def base(self):
-        """ Return the base object if the memory of the underlying data is
+        """ return the base object if the memory of the underlying data is
         shared
         """
         warnings.warn("{obj}.base is deprecated and will be removed "
@@ -818,7 +818,7 @@ def max(self):
 
     def argmax(self, axis=None):
         """
-        Return a ndarray of the maximum argument indexer
+        return a ndarray of the maximum argument indexer
 
         See Also
         --------
@@ -861,7 +861,7 @@ def min(self):
 
     def argmin(self, axis=None):
         """
-        Return a ndarray of the minimum argument indexer
+        return a ndarray of the minimum argument indexer
 
         See Also
         --------
@@ -900,7 +900,7 @@ def __iter__(self):
 
     @cache_readonly
     def hasnans(self):
-        """ Return if I have any nans; enables various perf speedups """
+        """ return if I have any nans; enables various perf speedups """
         return bool(isna(self).any())
 
     def _reduce(self, op, name, axis=0, skipna=True, numeric_only=None,

pandas/core/generic.py

@@ -2331,7 +2331,7 @@ def to_hdf(self, path_or_buf, key, **kwargs):
 
     def to_msgpack(self, path_or_buf=None, encoding='utf-8', **kwargs):
         """
-        Serialize object to input file path using msgpack format
+        msgpack (serialize) object to input file path
 
         THIS IS AN EXPERIMENTAL LIBRARY and the storage format
         may not be stable until a future release.

pandas/core/series.py

@@ -390,22 +390,22 @@ def name(self, value):
     # ndarray compatibility
     @property
     def dtype(self):
-        """ Return the dtype object of the underlying data """
+        """ return the dtype object of the underlying data """
         return self._data.dtype
 
     @property
     def dtypes(self):
-        """ Return the dtype object of the underlying data """
+        """ return the dtype object of the underlying data """
         return self._data.dtype
 
     @property
     def ftype(self):
-        """ Return if the data is sparse|dense """
+        """ return if the data is sparse|dense """
         return self._data.ftype
 
     @property
     def ftypes(self):
-        """ Return if the data is sparse|dense """
+        """ return if the data is sparse|dense """
         return self._data.ftype
 
     @property
@@ -443,7 +443,7 @@ def values(self):
 
     @property
     def _values(self):
-        """ Return the internal repr of this data """
+        """ return the internal repr of this data """
         return self._data.internal_values()
 
     def _formatting_values(self):
@@ -453,7 +453,7 @@ def _formatting_values(self):
         return self._data.formatting_values()
 
     def get_values(self):
-        """ Same as values (but handles sparseness conversions); is a view """
+        """ same as values (but handles sparseness conversions); is a view """
         return self._data.get_values()
 
     @property