DOC: Enforce Numpy Docstring Validation for pandas.HDFStore.select (#58374)

* DOC: add SA01 to HDFStore.select * DOC: remove HDFStore.select

Author: tuhinsharma121

ci/code_checks.sh

@@ -122,7 +122,6 @@ if [[ -z "$CHECK" || "$CHECK" == "docstrings" ]]; then
  -i "pandas.DatetimeTZDtype.unit SA01" \
  -i "pandas.Grouper PR02" \
  -i "pandas.HDFStore.put PR01,SA01" \
- -i "pandas.HDFStore.select SA01" \
  -i "pandas.HDFStore.walk SA01" \
  -i "pandas.Index PR07" \
  -i "pandas.Index.T SA01" \

pandas/io/pytables.py

@@ -859,6 +859,12 @@ def select(
  object
  Retrieved object from file.
 
+ See Also
+ --------
+ HDFStore.select_as_coordinates : Returns the selection as an index.
+ HDFStore.select_column : Returns a single column from the table.
+ HDFStore.select_as_multiple : Retrieves pandas objects from multiple tables.
+
  Examples
  --------
  >>> df = pd.DataFrame([[1, 2], [3, 4]], columns=["A", "B"])