Revert "Fix some dosctring RT02 error (#50197)"

This reverts commit bce9958.

Author: ShisuiUzumaki

pandas/core/arrays/interval.py

@@ -1368,7 +1368,7 @@ def closed(self) -> IntervalClosedType:
 
         Returns
         -------
-        %(klass)s
+        new_index : %(klass)s
 
         %(examples)s\
         """

pandas/core/arrays/sparse/accessor.py

@@ -316,7 +316,7 @@ def to_coo(self):
 
         Returns
         -------
-        scipy.sparse.spmatrix
+        coo_matrix : scipy.sparse.spmatrix
             If the caller is heterogeneous and contains booleans or objects,
             the result will be of dtype=object. See Notes.
 

pandas/core/dtypes/inference.py

@@ -43,7 +43,7 @@ def is_number(obj) -> bool:
 
     Returns
     -------
-    bool
+    is_number : bool
         Whether `obj` is a number or not.
 
     See Also
@@ -113,7 +113,7 @@ def is_file_like(obj) -> bool:
 
     Returns
     -------
-    bool
+    is_file_like : bool
         Whether `obj` has file-like properties.
 
     Examples
@@ -141,7 +141,7 @@ def is_re(obj) -> bool:
 
     Returns
     -------
-    bool
+    is_regex : bool
         Whether `obj` is a regex pattern.
 
     Examples
@@ -164,7 +164,7 @@ def is_re_compilable(obj) -> bool:
 
     Returns
     -------
-    bool
+    is_regex_compilable : bool
         Whether `obj` can be compiled as a regex pattern.
 
     Examples
@@ -270,7 +270,7 @@ def is_dict_like(obj) -> bool:
 
     Returns
     -------
-    bool
+    is_dict_like : bool
         Whether `obj` has dict-like properties.
 
     Examples
@@ -302,7 +302,7 @@ def is_named_tuple(obj) -> bool:
 
     Returns
     -------
-    bool
+    is_named_tuple : bool
         Whether `obj` is a named tuple.
 
     Examples

pandas/core/frame.py

@@ -8041,8 +8041,7 @@ def update(
 
         Returns
         -------
-        None
-            This method directly changes calling object.
+        None : method directly changes calling object
 
         Raises
         ------

pandas/core/generic.py

@@ -724,7 +724,7 @@ def set_axis(
 
         Returns
         -------
-        %(klass)s
+        renamed : %(klass)s
             An object of type %(klass)s.
 
         See Also
@@ -763,7 +763,7 @@ def swapaxes(
 
         Returns
         -------
-        same as input
+        y : same as input
         """
         i = self._get_axis_number(axis1)
         j = self._get_axis_number(axis2)
@@ -3712,7 +3712,7 @@ def take(self: NDFrameT, indices, axis: Axis = 0, **kwargs) -> NDFrameT:
 
         Returns
         -------
-        same type as caller
+        taken : same type as caller
             An array-like containing the elements taken from the object.
 
         See Also
@@ -4164,7 +4164,7 @@ def get(self, key, default=None):
 
         Returns
         -------
-        same type as items contained in object
+        value : same type as items contained in object
 
         Examples
         --------
@@ -5730,7 +5730,7 @@ def pipe(
 
         Returns
         -------
-        the return type of ``func``.
+        object : the return type of ``func``.
 
         See Also
         --------
@@ -6024,7 +6024,7 @@ def astype(
 
         Returns
         -------
-        same type as caller
+        casted : same type as caller
 
         See Also
         --------
@@ -6210,7 +6210,7 @@ def copy(self: NDFrameT, deep: bool_t | None = True) -> NDFrameT:
 
         Returns
         -------
-        Series or DataFrame
+        copy : Series or DataFrame
             Object type matches caller.
 
         Notes
@@ -6333,7 +6333,7 @@ def infer_objects(self: NDFrameT, copy: bool_t = True) -> NDFrameT:
 
         Returns
         -------
-        same type as input object
+        converted : same type as input object
 
         See Also
         --------
@@ -10630,7 +10630,7 @@ def pct_change(
 
         Returns
         -------
-        Series or DataFrame
+        chg : Series or DataFrame
             The same type as the calling object.
 
         See Also
@@ -11649,7 +11649,7 @@ def first_valid_index(self) -> Hashable | None:
 
         Returns
         -------
-        type of index
+        scalar : type of index
 
         Notes
         -----

pandas/core/groupby/generic.py

@@ -540,7 +540,7 @@ def filter(self, func, dropna: bool = True, *args, **kwargs):
 
         Returns
         -------
-        Series
+        filtered : Series
 
         Notes
         -----
@@ -1596,7 +1596,7 @@ def filter(self, func, dropna: bool = True, *args, **kwargs):
 
         Returns
         -------
-        DataFrame
+        filtered : DataFrame
 
         Notes
         -----

pandas/core/groupby/groupby.py

@@ -372,7 +372,7 @@ class providing the base-class of operations.
 
 Returns
 -------
-the return type of `func`.
+object : the return type of `func`.
 
 See Also
 --------
@@ -774,7 +774,7 @@ def get_group(self, name, obj=None) -> DataFrame | Series:
 
         Returns
         -------
-        same type as obj
+        group : same type as obj
         """
         if obj is None:
             obj = self._selected_obj

pandas/core/indexes/datetimes.py

@@ -838,7 +838,7 @@ def date_range(
 
     Returns
     -------
-    DatetimeIndex
+    rng : DatetimeIndex
 
     See Also
     --------

pandas/core/indexes/multi.py

@@ -1604,7 +1604,7 @@ def get_level_values(self, level):
 
         Returns
         -------
-        Index
+        values : Index
             Values is a level of this MultiIndex converted to
             a single :class:`Index` (or subclass thereof).
 
@@ -1678,7 +1678,7 @@ def to_frame(
 
         Returns
         -------
-        DataFrame
+        DataFrame : a DataFrame containing the original MultiIndex data.
 
         See Also
         --------
@@ -2744,7 +2744,7 @@ def get_loc(self, key):
 
         Returns
         -------
-        int, slice object or boolean mask
+        loc : int, slice object or boolean mask
             If the key is past the lexsort depth, the return may be a
             boolean mask array, otherwise it is always a slice or int.
 
@@ -2862,13 +2862,10 @@ def get_loc_level(self, key, level: IndexLabel = 0, drop_level: bool = True):
 
         Returns
         -------
-        tuple
-            A 2-tuple where the elements :
-
-            Element 0: int, slice object or boolean array.
-
-            Element 1: The resulting sliced multiindex/index. If the key
-            contains all levels, this will be ``None``.
+        loc : A 2-tuple where the elements are:
+              Element 0: int, slice object or boolean array
+              Element 1: The resulting sliced multiindex/index. If the key
+              contains all levels, this will be ``None``.
 
         See Also
         --------

pandas/core/resample.py

@@ -374,7 +374,7 @@ def transform(self, arg, *args, **kwargs):
 
         Returns
         -------
-        Series
+        transformed : Series
 
         Examples
         --------

pandas/core/reshape/merge.py

@@ -428,7 +428,7 @@ def merge_asof(
 
     Returns
     -------
-    DataFrame
+    merged : DataFrame
 
     See Also
     --------

pandas/core/strings/accessor.py

@@ -1601,7 +1601,7 @@ def pad(
 
     Returns
     -------
-    Series/Index of objects.
+    filled : Series/Index of objects.
     """
 
     @Appender(_shared_docs["str_pad"] % {"side": "left and right", "method": "center"})
@@ -1880,7 +1880,7 @@ def encode(self, encoding, errors: str = "strict"):
 
         Returns
         -------
-        Series/Index of objects
+        encoded : Series/Index of objects
         """
         result = self._data.array._str_encode(encoding, errors)
         return self._wrap_result(result, returns_string=False)
@@ -2767,7 +2767,7 @@ def normalize(self, form):
 
         Returns
         -------
-        Series/Index of objects
+        normalized : Series/Index of objects
         """
         result = self._data.array._str_normalize(form)
         return self._wrap_result(result)

pandas/io/json/_table_schema.py

@@ -249,7 +249,7 @@ def build_table_schema(
 
     Returns
     -------
-    dict
+    schema : dict
 
     Notes
     -----

pandas/io/pickle.py

@@ -141,7 +141,7 @@ def read_pickle(
 
     Returns
     -------
-    same type as object stored in file
+    unpickled : same type as object stored in file
 
     See Also
     --------

pandas/io/pytables.py

@@ -370,7 +370,7 @@ def read_hdf(
 
     Returns
     -------
-    object
+    item : object
         The selected object. Return type depends on the object stored.
 
     See Also