gh-71223: Improve rendering of some references in the docs (GH-93041)

For example, instead of "eval()uated" (link from "eval()")
show "evaluated" (link from the whole word).
This commit is contained in:
Serhiy Storchaka 2022-05-21 10:33:23 +03:00 committed by GitHub
parent 2fadde7e66
commit 7f835923c1
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
7 changed files with 16 additions and 9 deletions

View file

@ -293,7 +293,7 @@ There is the possibility that "dummy thread objects" are created. These are
thread objects corresponding to "alien threads", which are threads of control
started outside the threading module, such as directly from C code. Dummy
thread objects have limited functionality; they are always considered alive and
daemonic, and cannot be :meth:`~Thread.join`\ ed. They are never deleted,
daemonic, and cannot be :ref:`joined <meth-thread-join>`. They are never deleted,
since it is impossible to detect the termination of alien threads.
@ -366,6 +366,8 @@ since it is impossible to detect the termination of alien threads.
>>> t.run()
1
.. _meth-thread-join:
.. method:: join(timeout=None)
Wait until the thread terminates. This blocks the calling thread until
@ -383,7 +385,7 @@ since it is impossible to detect the termination of alien threads.
When the *timeout* argument is not present or ``None``, the operation will
block until the thread terminates.
A thread can be :meth:`~Thread.join`\ ed many times.
A thread can be joined many times.
:meth:`~Thread.join` raises a :exc:`RuntimeError` if an attempt is made
to join the current thread as that would cause a deadlock. It is also