mirror of
				https://github.com/python/cpython.git
				synced 2025-11-03 19:34:08 +00:00 
			
		
		
		
	Added a bunch of "concept" index entries.
Use trailing "()" on function names in running text.
This commit is contained in:
		
							parent
							
								
									a46f84d293
								
							
						
					
					
						commit
						61b0452626
					
				
					 2 changed files with 22 additions and 8 deletions
				
			
		| 
						 | 
					@ -7,10 +7,16 @@ threads (a.k.a.\ \dfn{light-weight processes} or \dfn{tasks}) --- multiple
 | 
				
			||||||
threads of control sharing their global data space.  For
 | 
					threads of control sharing their global data space.  For
 | 
				
			||||||
synchronization, simple locks (a.k.a.\ \dfn{mutexes} or \dfn{binary
 | 
					synchronization, simple locks (a.k.a.\ \dfn{mutexes} or \dfn{binary
 | 
				
			||||||
semaphores}) are provided.
 | 
					semaphores}) are provided.
 | 
				
			||||||
 | 
					\index{light-weight processes}
 | 
				
			||||||
 | 
					\index{processes, light-weight}
 | 
				
			||||||
 | 
					\index{binary semaphores}
 | 
				
			||||||
 | 
					\index{semaphores, binary}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
The module is optional.  It is supported on Windows NT and '95, SGI
 | 
					The module is optional.  It is supported on Windows NT and '95, SGI
 | 
				
			||||||
IRIX, Solaris 2.x, as well as on systems that have a POSIX thread
 | 
					IRIX, Solaris 2.x, as well as on systems that have a POSIX thread
 | 
				
			||||||
(a.k.a. ``pthread'') implementation.
 | 
					(a.k.a. ``pthread'') implementation.
 | 
				
			||||||
 | 
					\index{pthreads}
 | 
				
			||||||
 | 
					\indexii{threads}{posix}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
It defines the following constant and functions:
 | 
					It defines the following constant and functions:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					@ -87,8 +93,8 @@ thread, 0 if not.
 | 
				
			||||||
\item
 | 
					\item
 | 
				
			||||||
Threads interact strangely with interrupts: the
 | 
					Threads interact strangely with interrupts: the
 | 
				
			||||||
\code{KeyboardInterrupt} exception will be received by an arbitrary
 | 
					\code{KeyboardInterrupt} exception will be received by an arbitrary
 | 
				
			||||||
thread.  (When the \code{signal} module is available, interrupts
 | 
					thread.  (When the \code{signal}\refbimodindex{signal} module is
 | 
				
			||||||
always go to the main thread.)
 | 
					available, interrupts always go to the main thread.)
 | 
				
			||||||
 | 
					
 | 
				
			||||||
\item
 | 
					\item
 | 
				
			||||||
Calling \code{sys.exit()} or raising the \code{SystemExit} exception is
 | 
					Calling \code{sys.exit()} or raising the \code{SystemExit} exception is
 | 
				
			||||||
| 
						 | 
					@ -96,8 +102,8 @@ equivalent to calling \code{thread.exit_thread()}.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
\item
 | 
					\item
 | 
				
			||||||
Not all built-in functions that may block waiting for I/O allow other
 | 
					Not all built-in functions that may block waiting for I/O allow other
 | 
				
			||||||
threads to run.  (The most popular ones (\code{sleep}, \code{read},
 | 
					threads to run.  (The most popular ones (\code{sleep()}, \code{read()},
 | 
				
			||||||
\code{select}) work as expected.)
 | 
					\code{select()}) work as expected.)
 | 
				
			||||||
 | 
					
 | 
				
			||||||
\item
 | 
					\item
 | 
				
			||||||
It is not possible to interrupt the \code{acquire()} method on a lock
 | 
					It is not possible to interrupt the \code{acquire()} method on a lock
 | 
				
			||||||
| 
						 | 
					@ -109,6 +115,7 @@ When the main thread exits, it is system defined whether the other
 | 
				
			||||||
threads survive.  On SGI IRIX using the native thread implementation,
 | 
					threads survive.  On SGI IRIX using the native thread implementation,
 | 
				
			||||||
they survive.  On most other systems, they are killed without
 | 
					they survive.  On most other systems, they are killed without
 | 
				
			||||||
executing ``try-finally'' clauses or executing object destructors.
 | 
					executing ``try-finally'' clauses or executing object destructors.
 | 
				
			||||||
 | 
					\indexii{threads}{IRIX}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
\item
 | 
					\item
 | 
				
			||||||
When the main thread exits, it doesn't do any of its usual cleanup
 | 
					When the main thread exits, it doesn't do any of its usual cleanup
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -7,10 +7,16 @@ threads (a.k.a.\ \dfn{light-weight processes} or \dfn{tasks}) --- multiple
 | 
				
			||||||
threads of control sharing their global data space.  For
 | 
					threads of control sharing their global data space.  For
 | 
				
			||||||
synchronization, simple locks (a.k.a.\ \dfn{mutexes} or \dfn{binary
 | 
					synchronization, simple locks (a.k.a.\ \dfn{mutexes} or \dfn{binary
 | 
				
			||||||
semaphores}) are provided.
 | 
					semaphores}) are provided.
 | 
				
			||||||
 | 
					\index{light-weight processes}
 | 
				
			||||||
 | 
					\index{processes, light-weight}
 | 
				
			||||||
 | 
					\index{binary semaphores}
 | 
				
			||||||
 | 
					\index{semaphores, binary}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
The module is optional.  It is supported on Windows NT and '95, SGI
 | 
					The module is optional.  It is supported on Windows NT and '95, SGI
 | 
				
			||||||
IRIX, Solaris 2.x, as well as on systems that have a POSIX thread
 | 
					IRIX, Solaris 2.x, as well as on systems that have a POSIX thread
 | 
				
			||||||
(a.k.a. ``pthread'') implementation.
 | 
					(a.k.a. ``pthread'') implementation.
 | 
				
			||||||
 | 
					\index{pthreads}
 | 
				
			||||||
 | 
					\indexii{threads}{posix}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
It defines the following constant and functions:
 | 
					It defines the following constant and functions:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					@ -87,8 +93,8 @@ thread, 0 if not.
 | 
				
			||||||
\item
 | 
					\item
 | 
				
			||||||
Threads interact strangely with interrupts: the
 | 
					Threads interact strangely with interrupts: the
 | 
				
			||||||
\code{KeyboardInterrupt} exception will be received by an arbitrary
 | 
					\code{KeyboardInterrupt} exception will be received by an arbitrary
 | 
				
			||||||
thread.  (When the \code{signal} module is available, interrupts
 | 
					thread.  (When the \code{signal}\refbimodindex{signal} module is
 | 
				
			||||||
always go to the main thread.)
 | 
					available, interrupts always go to the main thread.)
 | 
				
			||||||
 | 
					
 | 
				
			||||||
\item
 | 
					\item
 | 
				
			||||||
Calling \code{sys.exit()} or raising the \code{SystemExit} exception is
 | 
					Calling \code{sys.exit()} or raising the \code{SystemExit} exception is
 | 
				
			||||||
| 
						 | 
					@ -96,8 +102,8 @@ equivalent to calling \code{thread.exit_thread()}.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
\item
 | 
					\item
 | 
				
			||||||
Not all built-in functions that may block waiting for I/O allow other
 | 
					Not all built-in functions that may block waiting for I/O allow other
 | 
				
			||||||
threads to run.  (The most popular ones (\code{sleep}, \code{read},
 | 
					threads to run.  (The most popular ones (\code{sleep()}, \code{read()},
 | 
				
			||||||
\code{select}) work as expected.)
 | 
					\code{select()}) work as expected.)
 | 
				
			||||||
 | 
					
 | 
				
			||||||
\item
 | 
					\item
 | 
				
			||||||
It is not possible to interrupt the \code{acquire()} method on a lock
 | 
					It is not possible to interrupt the \code{acquire()} method on a lock
 | 
				
			||||||
| 
						 | 
					@ -109,6 +115,7 @@ When the main thread exits, it is system defined whether the other
 | 
				
			||||||
threads survive.  On SGI IRIX using the native thread implementation,
 | 
					threads survive.  On SGI IRIX using the native thread implementation,
 | 
				
			||||||
they survive.  On most other systems, they are killed without
 | 
					they survive.  On most other systems, they are killed without
 | 
				
			||||||
executing ``try-finally'' clauses or executing object destructors.
 | 
					executing ``try-finally'' clauses or executing object destructors.
 | 
				
			||||||
 | 
					\indexii{threads}{IRIX}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
\item
 | 
					\item
 | 
				
			||||||
When the main thread exits, it doesn't do any of its usual cleanup
 | 
					When the main thread exits, it doesn't do any of its usual cleanup
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
		Loading…
	
	Add table
		Add a link
		
	
		Reference in a new issue