diff --git a/pandas/core/generic.py b/pandas/core/generic.py index 8aa8f8bb60654..2bbd261faeddf 100644 --- a/pandas/core/generic.py +++ b/pandas/core/generic.py @@ -4239,11 +4239,11 @@ def sort_values( def reindex(self: FrameOrSeries, *args, **kwargs) -> FrameOrSeries: """ - Conform %(klass)s to new index with optional filling logic. + Create an object with a new index and columns retained from %(klass)s. - Places NA/NaN in locations having no value in the previous index. A new object - is produced unless the new index is equivalent to the current one and - ``copy=False``. + The values are only retained for index that matches in %(klass)s else NA/Nan. + If the new index is entirely equivalent to the current one and copy=false the + %(klass)s remains intact. Parameters ---------- @@ -4286,7 +4286,7 @@ def reindex(self: FrameOrSeries, *args, **kwargs) -> FrameOrSeries: Returns ------- - %(klass)s with changed index. + %(klass)s with a new index. See Also --------