replace with bullet

Author: thoo

pandas/core/algorithms.py

@@ -289,9 +289,12 @@ def unique(values):
     Returns
     -------
     unique values
-        If the input is an Index, the return is an Index.\n
-        If the input is a Categorical dtype, the return is a Categorical.\n
-        If the input is a Series/ndarray, the return will be an ndarray.
+
+        The return can be:
+
+        - If the input is an Index, the return is an Index.
+        - If the input is a Categorical dtype, the return is a Categorical.
+        - If the input is a Series/ndarray, the return will be an ndarray.
 
     See Also
     --------

pandas/core/frame.py

@@ -1161,7 +1161,7 @@ def to_numpy(self, dtype=None, copy=False):
 
         Returns
         -------
-        array : numpy.ndarray
+        numpy.ndarray
 
         See Also
         --------
@@ -1455,7 +1455,7 @@ def from_records(cls, data, index=None, exclude=None, columns=None,
 
         Returns
         -------
-        df : DataFrame
+        DataFrame
         """
 
         # Make a copy of the input columns so we can modify it
@@ -1771,7 +1771,7 @@ def from_items(cls, items, columns=None, orient='columns'):
 
         Returns
         -------
-        frame : DataFrame
+        DataFrame
         """
 
         warnings.warn("from_items is deprecated. Please use "
@@ -1882,7 +1882,7 @@ def from_csv(cls, path, header=0, sep=',', index_col=0, parse_dates=True,
 
         Returns
         -------
-        y : DataFrame
+        DataFrame
 
         See Also
         --------
@@ -1972,7 +1972,7 @@ def to_panel(self):
 
         Returns
         -------
-        panel : Panel
+        Panel
         """
         # only support this kind for now
         if (not isinstance(self.index, MultiIndex) or  # pragma: no cover
@@ -2532,7 +2532,7 @@ def memory_usage(self, index=True, deep=False):
 
         Returns
         -------
-        sizes : Series
+        Series
             A Series whose index is the original column names and whose values
             is the memory usage of each column in bytes.
 
@@ -2750,7 +2750,7 @@ def get_value(self, index, col, takeable=False):
 
         Returns
         -------
-        value : scalar value
+        scalar value
         """
 
         warnings.warn("get_value is deprecated and will be removed "
@@ -2795,7 +2795,7 @@ def set_value(self, index, col, value, takeable=False):
 
         Returns
         -------
-        frame : DataFrame
+        DataFrame
             If label pair is contained, will be reference to calling DataFrame,
             otherwise a new object.
         """
@@ -3231,7 +3231,7 @@ def select_dtypes(self, include=None, exclude=None):
 
         Returns
         -------
-        subset : DataFrame
+        DataFrame
             The subset of the frame including the dtypes in ``include`` and
             excluding the dtypes in ``exclude``.
 
@@ -3596,7 +3596,7 @@ def _sanitize_column(self, key, value, broadcast=True):
 
         Returns
         -------
-        sanitized_column : numpy-array
+        numpy-array
         """
 
         def reindexer(value):
@@ -3865,7 +3865,7 @@ def drop(self, labels=None, axis=0, index=None, columns=None,
 
         Returns
         -------
-        dropped : pandas.DataFrame
+        pandas.DataFrame
 
         Raises
         ------
@@ -3990,7 +3990,7 @@ def rename(self, *args, **kwargs):
 
         Returns
         -------
-        renamed : DataFrame
+        DataFrame
 
         See Also
         --------
@@ -4639,7 +4639,7 @@ def drop_duplicates(self, subset=None, keep='first', inplace=False):
 
         Returns
         -------
-        deduplicated : DataFrame
+        DataFrame
         """
         if self.empty:
             return self.copy()
@@ -4673,7 +4673,7 @@ def duplicated(self, subset=None, keep='first'):
 
         Returns
         -------
-        duplicated : Series
+        Series
         """
         from pandas.core.sorting import get_group_index
         from pandas._libs.hashtable import duplicated_int64, _SIZE_HINT_LIMIT
@@ -5041,7 +5041,7 @@ def swaplevel(self, i=-2, j=-1, axis=0):
 
         Returns
         -------
-        swapped : same type as caller (new object)
+        same type as caller (new object)
 
         .. versionchanged:: 0.18.1
 
@@ -5320,7 +5320,7 @@ def combine_first(self, other):
 
         Returns
         -------
-        combined : DataFrame
+        DataFrame
 
         See Also
         --------
@@ -5681,7 +5681,7 @@ def pivot(self, index=None, columns=None, values=None):
 
         Returns
         -------
-        table : DataFrame
+        DataFrame
 
         See Also
         --------
@@ -5967,7 +5967,7 @@ def unstack(self, level=-1, fill_value=None):
 
         Returns
         -------
-        unstacked : DataFrame or Series
+        DataFrame or Series
 
         See Also
         --------
@@ -6133,7 +6133,7 @@ def diff(self, periods=1, axis=0):
 
         Returns
         -------
-        diffed : DataFrame
+        DataFrame
 
         See Also
         --------
@@ -6405,7 +6405,7 @@ def apply(self, func, axis=0, broadcast=None, raw=False, reduce=None,
 
         Returns
         -------
-        applied : Series or DataFrame
+        Series or DataFrame
 
         See Also
         --------
@@ -6598,7 +6598,7 @@ def append(self, other, ignore_index=False,
 
         Returns
         -------
-        appended : DataFrame
+        DataFrame
 
         See Also
         --------
@@ -6908,7 +6908,7 @@ def round(self, decimals=0, *args, **kwargs):
 
         Returns
         -------
-        DataFrame :
+        DataFrame
             A DataFrame with the affected columns rounded to the specified
             number of decimal places.
 
@@ -7021,7 +7021,7 @@ def corr(self, method='pearson', min_periods=1):
 
         Returns
         -------
-        y : DataFrame
+        DataFrame
 
         See Also
         --------
@@ -7215,7 +7215,7 @@ def corrwith(self, other, axis=0, drop=False, method='pearson'):
 
         Returns
         -------
-        correls : Series
+        Series
 
         See Also
         -------
@@ -7545,7 +7545,7 @@ def nunique(self, axis=0, dropna=True):
 
         Returns
         -------
-        nunique : Series
+        Series
 
         See Also
         --------
@@ -7583,7 +7583,7 @@ def idxmin(self, axis=0, skipna=True):
 
         Returns
         -------
-        idxmin : Series
+        Series
 
         Raises
         ------
@@ -7619,7 +7619,7 @@ def idxmax(self, axis=0, skipna=True):
 
         Returns
         -------
-        idxmax : Series
+        Series
 
         Raises
         ------
@@ -7766,7 +7766,7 @@ def quantile(self, q=0.5, axis=0, numeric_only=True,
 
         Returns
         -------
-        quantiles : Series or DataFrame
+        Series or DataFrame
 
             If ``q`` is an array, a DataFrame will be returned where the
               index is ``q``, the columns are the columns of self, and the
@@ -7848,7 +7848,7 @@ def to_timestamp(self, freq=None, how='start', axis=0, copy=True):
 
         Returns
         -------
-        df : DataFrame with DatetimeIndex
+        DataFrame with DatetimeIndex
         """
         new_data = self._data
         if copy:
@@ -7880,7 +7880,7 @@ def to_period(self, freq=None, axis=0, copy=True):
 
         Returns
         -------
-        ts : TimeSeries with PeriodIndex
+        TimeSeries with PeriodIndex
         """
         new_data = self._data
         if copy:

pandas/core/generic.py

@@ -4951,11 +4951,14 @@ def pipe(self, func, *args, **kwargs):
     Returns
     -------
     DataFrame, Series or scalar
-        If DataFrame.agg is called with a single function, returns a Series.\n
-        If DataFrame.agg is called with several functions, returns
-        a DataFrame.\n
-        If Series.agg is called with single function, returns a scalar.\n
-        If Series.agg is called with several functions, returns a Series.
+
+        The return can be:
+
+        - If DataFrame.agg is called with a single function, returns a Series.
+        - If DataFrame.agg is called with several functions, returns
+          a DataFrame.
+        - If Series.agg is called with single function, returns a scalar.
+        - If Series.agg is called with several functions, returns a Series.
 
     %(see_also)s
 
@@ -6879,11 +6882,14 @@ def asof(self, where, subset=None):
         -------
         scalar, Series, or DataFrame
 
-           Scalar : when `self` is a Series and `where` is a scalar
-           Series: when `self` is a Series and `where` is an array-like,
-             or when `self` is a DataFrame and `where` is a scalar
-           DataFrame : when `self` is a DataFrame and `where` is an
-             array-like.
+            The return can be:
+
+            * Scalar : when `self` is a Series and `where` is a scalar
+            * Series: when `self` is a Series and `where` is an array-like,
+              or when `self` is a DataFrame and `where` is a scalar
+            * DataFrame : when `self` is a DataFrame and `where` is an
+              array-like
+            Return scala, Sereis, or DataFrame.
 
         See Also
         --------

pandas/plotting/_core.py

@@ -2060,9 +2060,9 @@ def plot_series(data, kind='line', ax=None,                    # Series unique
 
         For data grouped with ``by``:
 
-        * :class:`~pandas.Series`
+        * :class:`~pandas.Series` \n
         * :class:`~numpy.array` (for ``return_type = None``)
-        Return N-dimentional array.
+        Return Series or numpy.array.
 
     See Also
     --------