update docs

Author: jbrockmendel

doc/redirects.csv

@@ -358,7 +358,6 @@ generated/pandas.DataFrame.ewm,../reference/api/pandas.DataFrame.ewm
 generated/pandas.DataFrame.expanding,../reference/api/pandas.DataFrame.expanding
 generated/pandas.DataFrame.ffill,../reference/api/pandas.DataFrame.ffill
 generated/pandas.DataFrame.fillna,../reference/api/pandas.DataFrame.fillna
-generated/pandas.DataFrame.filter,../reference/api/pandas.DataFrame.filter
 generated/pandas.DataFrame.first,../reference/api/pandas.DataFrame.first
 generated/pandas.DataFrame.first_valid_index,../reference/api/pandas.DataFrame.first_valid_index
 generated/pandas.DataFrame.floordiv,../reference/api/pandas.DataFrame.floordiv
@@ -1023,7 +1022,6 @@ generated/pandas.Series.expanding,../reference/api/pandas.Series.expanding
 generated/pandas.Series.factorize,../reference/api/pandas.Series.factorize
 generated/pandas.Series.ffill,../reference/api/pandas.Series.ffill
 generated/pandas.Series.fillna,../reference/api/pandas.Series.fillna
-generated/pandas.Series.filter,../reference/api/pandas.Series.filter
 generated/pandas.Series.first,../reference/api/pandas.Series.first
 generated/pandas.Series.first_valid_index,../reference/api/pandas.Series.first_valid_index
 generated/pandas.Series.floordiv,../reference/api/pandas.Series.floordiv

doc/source/reference/frame.rst

@@ -184,7 +184,6 @@ Reindexing / selection / label manipulation
    DataFrame.drop_duplicates
    DataFrame.duplicated
    DataFrame.equals
-   DataFrame.filter
    DataFrame.idxmax
    DataFrame.idxmin
    DataFrame.reindex
@@ -193,6 +192,7 @@ Reindexing / selection / label manipulation
    DataFrame.rename_axis
    DataFrame.reset_index
    DataFrame.sample
+   DataFrame.select
    DataFrame.set_axis
    DataFrame.set_index
    DataFrame.take

doc/source/reference/series.rst

@@ -201,7 +201,7 @@ Reindexing / selection / label manipulation
    Series.mask
    Series.add_prefix
    Series.add_suffix
-   Series.filter
+   Series.select
 
 Missing data handling
 ---------------------

doc/source/user_guide/gotchas.rst

@@ -165,7 +165,7 @@ Mutating with User Defined Function (UDF) methods
 
 This section applies to pandas methods that take a UDF. In particular, the methods
 :meth:`DataFrame.apply`, :meth:`DataFrame.aggregate`, :meth:`DataFrame.transform`, and
-:meth:`DataFrame.filter`.
+:meth:`DataFrame.select`.
 
 It is a general rule in programming that one should not mutate a container
 while it is being iterated over. Mutation will invalidate the iterator,

doc/source/user_guide/user_defined_functions.rst

@@ -261,13 +261,13 @@ calling multiple functions.
 
 When to use: Use :meth:`pipe` when you need to create a pipeline of operations and want to keep the code readable and maintainable.
 
-.. _udf.filter:
+.. _udf.select:
 
-:meth:`Series.filter` and :meth:`DataFrame.filter`
+:meth:`Series.select` and :meth:`DataFrame.select`
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The ``filter`` method is used to select a subset of rows that match certain criteria.
-:meth:`Series.filter` and :meth:`DataFrame.filter` do not support user defined functions,
+The ``select`` method is used to select a subset of rows that match certain criteria.
+:meth:`Series.select` and :meth:`DataFrame.select` do not support user defined functions,
 but :meth:`SeriesGroupBy.filter` and :meth:`DataFrameGroupBy.filter` do. You can read more
 about ``filter`` in groupby operations in :ref:`groupby.filter`.
 

pandas/core/groupby/generic.py

@@ -756,7 +756,7 @@ def filter(self, func, dropna: bool = True, *args, **kwargs):
 
         See Also
         --------
-        Series.filter: Filter elements of ungrouped Series.
+        Series.select : Select elements of ungrouped Series.
         DataFrameGroupBy.filter : Filter elements from groups base on criterion.
 
         Notes
@@ -2380,7 +2380,7 @@ def filter(self, func, dropna: bool = True, *args, **kwargs) -> DataFrame:
 
         See Also
         --------
-        DataFrame.filter: Filter elements of ungrouped DataFrame.
+        DataFrame.select: Select elements of ungrouped DataFrame.
         SeriesGroupBy.filter : Filter elements from groups base on criterion.
 
         Notes