mirror of https://github.com/python/cpython
Patch #1680978: consistently use "alive" instead of "active" in the
thread lib doc.
This commit is contained in:
parent
72d9eec1bb
commit
8784bae65d
|
@ -15,10 +15,9 @@ situations where \module{threading} cannot be used because
|
|||
This module defines the following functions and objects:
|
||||
|
||||
\begin{funcdesc}{activeCount}{}
|
||||
Return the number of currently active \class{Thread} objects.
|
||||
The returned count is equal to the length of the list returned by
|
||||
Return the number of \class{Thread} objects currently alive. The
|
||||
returned count is equal to the length of the list returned by
|
||||
\function{enumerate()}.
|
||||
A function that returns the number of currently active threads.
|
||||
\end{funcdesc}
|
||||
|
||||
\begin{funcdesc}{Condition}{}
|
||||
|
@ -36,10 +35,10 @@ is returned.
|
|||
\end{funcdesc}
|
||||
|
||||
\begin{funcdesc}{enumerate}{}
|
||||
Return a list of all currently active \class{Thread} objects.
|
||||
The list includes daemonic threads, dummy thread objects created
|
||||
by \function{currentThread()}, and the main thread. It excludes terminated
|
||||
threads and threads that have not yet been started.
|
||||
Return a list of all \class{Thread} objects currently alive. The list
|
||||
includes daemonic threads, dummy thread objects created by
|
||||
\function{currentThread()}, and the main thread. It excludes
|
||||
terminated threads and threads that have not yet been started.
|
||||
\end{funcdesc}
|
||||
|
||||
\begin{funcdesc}{Event}{}
|
||||
|
@ -526,12 +525,9 @@ calling the thread's \method{start()} method. This invokes the
|
|||
\method{run()} method in a separate thread of control.
|
||||
|
||||
Once the thread's activity is started, the thread is considered
|
||||
'alive' and 'active' (these concepts are almost, but not quite
|
||||
exactly, the same; their definition is intentionally somewhat
|
||||
vague). It stops being alive and active when its \method{run()}
|
||||
method terminates -- either normally, or by raising an unhandled
|
||||
exception. The \method{isAlive()} method tests whether the thread is
|
||||
alive.
|
||||
'alive'. It stops being alive when its \method{run()} method terminates
|
||||
-- either normally, or by raising an unhandled exception. The
|
||||
\method{isAlive()} method tests whether the thread is alive.
|
||||
|
||||
Other threads can call a thread's \method{join()} method. This blocks
|
||||
the calling thread until the thread whose \method{join()} method is
|
||||
|
@ -551,14 +547,13 @@ There is a ``main thread'' object; this corresponds to the
|
|||
initial thread of control in the Python program. It is not a
|
||||
daemon thread.
|
||||
|
||||
There is the possibility that ``dummy thread objects'' are
|
||||
created. These are thread objects corresponding to ``alien
|
||||
threads''. These 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,
|
||||
active, and daemonic, and cannot be \method{join()}ed. They are never
|
||||
deleted, since it is impossible to detect the termination of alien
|
||||
threads.
|
||||
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 \method{join()}ed. They are never deleted, since it is
|
||||
impossible to detect the termination of alien threads.
|
||||
|
||||
|
||||
\begin{classdesc}{Thread}{group=None, target=None, name=None,
|
||||
|
@ -646,7 +641,8 @@ name. The initial name is set by the constructor.
|
|||
Return whether the thread is alive.
|
||||
|
||||
Roughly, a thread is alive from the moment the \method{start()} method
|
||||
returns until its \method{run()} method terminates.
|
||||
returns until its \method{run()} method terminates. The module
|
||||
function \function{enumerate()} returns a list of all alive threads.
|
||||
\end{methoddesc}
|
||||
|
||||
\begin{methoddesc}{isDaemon}{}
|
||||
|
@ -659,8 +655,8 @@ This must be called before \method{start()} is called.
|
|||
|
||||
The initial value is inherited from the creating thread.
|
||||
|
||||
The entire Python program exits when no active non-daemon
|
||||
threads are left.
|
||||
The entire Python program exits when no alive non-daemon threads are
|
||||
left.
|
||||
\end{methoddesc}
|
||||
|
||||
|
||||
|
|
Loading…
Reference in New Issue