fix as recommended

Author: thoo

pandas/core/algorithms.py

@@ -292,9 +292,11 @@ def unique(values):
 
         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.
+        * Index : when the input is an Index
+        * Categorical : when the input is a Categorical dtype
+        * ndarray : when the input is a Series/ndarray
+
+        Return numpy.ndarray or ExtensionArray
 
     See Also
     --------

pandas/core/frame.py

@@ -6955,6 +6955,7 @@ def corr(self, method='pearson', min_periods=1):
             * spearman : Spearman rank correlation
             * callable: callable with input two 1d ndarrays
                 and returning a float
+
                 .. versionadded:: 0.24.0
 
         min_periods : int, optional

pandas/core/generic.py

@@ -2807,21 +2807,25 @@ def to_latex(self, buf=None, columns=None, col_space=None, header=True,
             defaults to 'ascii' on Python 2 and 'utf-8' on Python 3.
         decimal : str, default '.'
             Character recognized as decimal separator, e.g. ',' in Europe.
+
             .. versionadded:: 0.18.0
         multicolumn : bool, default True
             Use \multicolumn to enhance MultiIndex columns.
             The default will be read from the config module.
+
             .. versionadded:: 0.20.0
         multicolumn_format : str, default 'l'
             The alignment for multicolumns, similar to `column_format`
             The default will be read from the config module.
+
             .. versionadded:: 0.20.0
         multirow : bool, default False
             Use \multirow to enhance MultiIndex rows. Requires adding a
             \usepackage{multirow} to your LaTeX preamble. Will print
             centered labels (instead of top-aligned) across the contained
             rows, separating groups via clines. The default will be read
             from the pandas config module.
+
             .. versionadded:: 0.20.0
 
         Returns
@@ -4948,15 +4952,15 @@ def pipe(self, func, *args, **kwargs):
 
     Returns
     -------
-    DataFrame, Series or scalar
+    scalar, Series or DataFrame
 
         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.
+        * scalar : when Series.agg is called with single function
+        * Series : when DataFrame.agg is called with a single function
+        * DataFrame : when DataFrame.agg is called with several functions
+
+        Return scalar, Series or DataFrame.
 
     %(see_also)s
 
@@ -6885,12 +6889,13 @@ def asof(self, where, subset=None):
 
             The return can be:
 
-            * Scalar : when `self` is a Series and `where` is a scalar
+            * 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 scalar, Sereis, or DataFrame.
+
+            Return scalar, Series, or DataFrame.
 
         See Also
         --------

pandas/core/indexes/base.py

@@ -2972,8 +2972,11 @@ def _convert_listlike_indexer(self, keyarr, kind=None):
         Returns
         -------
         indexer, keyarr
-            indexer is an ndarray or None if cannot convert
-            keyarr are tuple-safe keys.
+            The return can be:
+            - indexer : an ndarray or None if cannot convert
+            - keyarr : tuple-safe keys
+
+            Return indexer, keyarr.
         """
         if isinstance(keyarr, Index):
             keyarr = self._convert_index_indexer(keyarr)

pandas/core/series.py

@@ -1668,6 +1668,7 @@ def unique(self):
             * Interval
             * Sparse
             * IntegerNA
+
         See Examples section.
 
         Examples

pandas/io/excel/_base.py

@@ -508,7 +508,9 @@ class ExcelWriter(object):
         Format string for datetime objects written into Excel files
         (e.g. 'YYYY-MM-DD HH:MM:SS')
     mode : {'w' or 'a'}, default 'w'
-        File mode to use (write or append). .. versionadded:: 0.24.0
+        File mode to use (write or append).
+
+        .. versionadded:: 0.24.0
 
     Attributes
     ----------