Shouldn't the docs mention pip search is deprecated on PyPi?

[JamesParrott]

What's the problem this feature will solve?

pip search has been deprecated on PyPi, but the docs for pip search don't mention anything about this

readable docs: https://pip.pypa.io/en/stable/cli/pip_search/
source for docs: https://github.com/pypa/pip/blob/main/docs/html/cli/pip_search.rst

Describe the solution you'd like

The documentation to mention that pip search now requires a custom repository

Alternative Solutions

Any alternative solution than simply adding a line to the docs is way more work, and unneccessary.

Additional context

https://warehouse.pypa.io/api-reference/xml-rpc.html#deprecated-methods
https://status.python.org/incidents/grk0k7sz6zkp

# pip search requests
ERROR: XMLRPC request failed [code: -32500]
RuntimeError: PyPI no longer supports 'pip search' (or XML-RPC search). Please use https://pypi.org/search (via a browser) instead. See https://warehouse.pypa.io/api-reference/xml-rpc.html#deprecated-methods for more information.

Code of Conduct

• I agree to follow the PSF Code of Conduct.

[pradyunsg]

Seems reasonable to me! I think adding a link to the warehouse documentation, to reflect this is likely a good idea. :)

[pradyunsg]

I've labelled this issue as an "awaiting PR". This label is essentially for indicating that the next step here is for someone to file a PR implementing the suggested change.