mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-08-03 08:34:29 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 6

mass changes; fix titles; add examples; correct typos; clarifications;

Browse source 
unified style; etc.
This commit is contained in:
Guido van Rossum 1995-03-17 16:07:09 +00:00
parent 7760cdea81
commit 470be14c8a
131 changed files with 1960 additions and 1114 deletions
Download patch file Download diff file Expand all files Collapse all files

34
Doc/libthread.tex
View file

@ -26,18 +26,22 @@ terminates with an unhandled exception, a stack trace is printed and
then the thread exits (but other threads continue to run).
\end{funcdesc}
\begin{funcdesc}{exit_thread}{}
Exit the current thread silently. Other threads continue to run.
\strong{Caveat:} code in pending \code{finally} clauses is not executed.
\begin{funcdesc}{exit}{}
This is a shorthand for \code{thread.exit_thread()}.
\end{funcdesc}
\begin{funcdesc}{exit_prog}{status}
Exit all threads and report the value of the integer argument
\var{status} as the exit status of the entire program.
\strong{Caveat:} code in pending \code{finally} clauses, in this thread
or in other threads, is not executed.
\begin{funcdesc}{exit_thread}{}
Raise the \code{SystemExit} exception. When not caught, this will
cause the thread to exit silently.
\end{funcdesc}
%\begin{funcdesc}{exit_prog}{status}
%Exit all threads and report the value of the integer argument
%\var{status} as the exit status of the entire program.
%\strong{Caveat:} code in pending \code{finally} clauses, in this thread
%or in other threads, is not executed.
%\end{funcdesc}
\begin{funcdesc}{allocate_lock}{}
Return a new lock object. Methods of locks are described below. The
lock is initially unlocked.
@ -82,18 +86,16 @@ thread, 0 if not.
\item
Threads interact strangely with interrupts: the
\code{KeyboardInterrupt} exception will be received by an arbitrary
thread.
thread. (When the \code{signal} module is available, interrupts
always go to the main thread.)
\item
Calling \code{sys.exit(\var{status})} or executing
\code{raise SystemExit, \var{status}} is almost equivalent to calling
\code{thread.exit_prog(\var{status})}, except that the former ways of
exiting the entire program do honor \code{finally} clauses in the
current thread (but not in other threads).
Calling \code{sys.exit()} or raising the \code{SystemExit} is
equivalent to calling \code{thread.exit_thread()}.
\item
Not all built-in functions that may block waiting for I/O allow other
threads to run, although the most popular ones (\code{sleep},
\code{read}, \code{select}) work as expected.
threads to run. (The most popular ones (\code{sleep}, \code{read},
\code{select}) work as expected.)
\end{itemize}