documentation for `http.server` refers to wrong `test()` function

[yedpodtrzitko]

Documentation

the following paragraph in docs for http.server mentions function test:

cpython/Doc/library/http.server.rst

Lines 395 to 396 in e3b6ff1

	For example usage, see the implementation of the :func:`test` function
	invocation in the :mod:`http.server` module.

which is a reference to function test in the same file:

cpython/Lib/http/server.py

Line 1239 in 9a95fa9

def test(HandlerClass=BaseHTTPRequestHandler,

but in the rendered docs :func:`test` is resolved as a link to https://docs.python.org/3/library/test.html#module-test instead of the aforementioned function in the same file.

[orsenthil]

Could open a pull request to fix this?

[yedpodtrzitko]

sure, I just dont know what's the recommended way how to refer to a specific function in the code - do I use link with the latest commit or is it preferred some other way?

[davidism]

List the full path to the name, it will be a link with the text http.server.test:

For example, see the implementation of the :func:`http.server.test` function.

Alternatively, add a ~ at the front, and it will remain in the current format, showing only the test name.

For example, see the implementation of the :func:`~http.server.test` function in the :mod:`http.server` module.