diff options
author | Guido van Rossum <guido@python.org> | 1994-08-12 13:13:50 (GMT) |
---|---|---|
committer | Guido van Rossum <guido@python.org> | 1994-08-12 13:13:50 (GMT) |
commit | b8b264b165fea8edd388886025615fc1fbcb603c (patch) | |
tree | 60cc9b78c8b44bb06eba3f6a3b601ea8415485e3 /Doc | |
parent | 0b7d02a36f86bdda0831c1c97917a82ff79d2991 (diff) | |
download | cpython-b8b264b165fea8edd388886025615fc1fbcb603c.zip cpython-b8b264b165fea8edd388886025615fc1fbcb603c.tar.gz cpython-b8b264b165fea8edd388886025615fc1fbcb603c.tar.bz2 |
* Doc/libfuncs.tex: don't use $math$ in description of pow(x,y,z);
describe tuple()
* Doc/libposixfile.tex: use tableiii instead of tableii, so
partparse will work again (I know, chicken!)
* Doc/libthread.tex: Added get_ident(); updated text on module
availability
* Doc/myformat.perl: Added sub do_cmd_Cpp
Diffstat (limited to 'Doc')
-rw-r--r-- | Doc/lib/libfuncs.tex | 14 | ||||
-rw-r--r-- | Doc/lib/libposixfile.tex | 22 | ||||
-rw-r--r-- | Doc/lib/libthread.tex | 12 | ||||
-rw-r--r-- | Doc/libfuncs.tex | 14 | ||||
-rw-r--r-- | Doc/libposixfile.tex | 22 | ||||
-rw-r--r-- | Doc/libthread.tex | 12 | ||||
-rw-r--r-- | Doc/myformat.perl | 1 |
7 files changed, 69 insertions, 28 deletions
diff --git a/Doc/lib/libfuncs.tex b/Doc/lib/libfuncs.tex index b37920d..379011d 100644 --- a/Doc/lib/libfuncs.tex +++ b/Doc/lib/libfuncs.tex @@ -239,8 +239,10 @@ there's no reliable way to determine whether this is the case.} \end{funcdesc} \begin{funcdesc}{pow}{x\, y\optional{\, z}} - Return \var{x} to the power \var{y}; if \var{z} is present, $x^y \bmod z$ - is returned. The arguments must have + Return \var{x} to the power \var{y}; if \var{z} is present, return + \var{x} to the power \var{y}, modulo \var{z} (computed more + efficiently that \code{pow(\var{x}, \var{y}) \% \var{z}}). + The arguments must have numeric types. With mixed operand types, the rules for binary arithmetic operators apply. The effective operand type is also the type of the result; if the result is not expressible in this type, the @@ -354,6 +356,14 @@ always attempt to return a string that is acceptable to \code{eval()}; its goal is to return a printable string. \end{funcdesc} +\begin{funcdesc}{tuple}{object} +Return a tuple whose items are the same and in the same order as +\var{object}'s items. If \var{object} is alread a tuple, it +is returned unchanged. For instance, \code{tuple('abc')} returns +returns \code{('a', 'b', 'c')} and \code{tuple([1, 2, 3])} returns +\code{(1, 2, 3)}. +\end{funcdesc} + \begin{funcdesc}{type}{object} % XXXJH xref to buil-in objects here? Return the type of an \var{object}. The return value is a type diff --git a/Doc/lib/libposixfile.tex b/Doc/lib/libposixfile.tex index 0d9cb32..346f576 100644 --- a/Doc/lib/libposixfile.tex +++ b/Doc/lib/libposixfile.tex @@ -92,11 +92,11 @@ All methods return \code{IOError} when the request fails. Format characters for the \code{lock()} method have the following meaning: -\begin{tableii}{|c|l|}{samp}{Format}{Meaning} - \lineii{u}{unlock the specified region} - \lineii{r}{request a read lock for the specified section} - \lineii{w}{request a write lock for the specified section} -\end{tableii} +\begin{tableiii}{|c|l|c|}{samp}{Format}{Meaning}{} + \lineiii{u}{unlock the specified region}{} + \lineiii{r}{request a read lock for the specified section}{} + \lineiii{w}{request a write lock for the specified section}{} +\end{tableiii} In addition the following modifiers can be added to the format: @@ -115,12 +115,12 @@ is for query purposes only. Format character for the \code{flags()} method have the following meaning: -\begin{tableii}{|c|l|}{samp}{Format}{Meaning} - \lineii{a}{append only flag} - \lineii{c}{close on exec flag} - \lineii{n}{no delay flag (also called non-blocking flag)} - \lineii{s}{synchronization flag} -\end{tableii} +\begin{tableiii}{|c|l|c|}{samp}{Format}{Meaning}{} + \lineiii{a}{append only flag}{} + \lineiii{c}{close on exec flag}{} + \lineiii{n}{no delay flag (also called non-blocking flag)}{} + \lineiii{s}{synchronization flag}{} +\end{tableiii} In addition the following modifiers can be added to the format: diff --git a/Doc/lib/libthread.tex b/Doc/lib/libthread.tex index c836615..4208c2d 100644 --- a/Doc/lib/libthread.tex +++ b/Doc/lib/libthread.tex @@ -7,7 +7,9 @@ threads of control sharing their global data space. For synchronization, simple locks (a.k.a. \dfn{mutexes} or \dfn{binary semaphores}) are provided. -The module is optional and supported on SGI and Sun Sparc systems only. +The module is optional and supported on SGI IRIX 4.x and 5.x and Sun +Solaris 2.x systems, as well as on systems that have a PTHREAD +implementation (e.g. KSR). It defines the following constant and functions: @@ -41,6 +43,14 @@ Return a new lock object. Methods of locks are described below. The lock is initially unlocked. \end{funcdesc} +\begin{funcdesc}{get_ident}{} +Return the `thread identifier' of the current thread. This is a +nonzero integer. Its value has no direct meaning; it is intended as a +magic cookie to be used e.g. to index a dictionary of thread-specific +data. Thread identifiers may be recycled when a thread exits and +another thread is created. +\end{funcdesc} + Lock objects have the following methods: \renewcommand{\indexsubitem}{(lock method)} diff --git a/Doc/libfuncs.tex b/Doc/libfuncs.tex index b37920d..379011d 100644 --- a/Doc/libfuncs.tex +++ b/Doc/libfuncs.tex @@ -239,8 +239,10 @@ there's no reliable way to determine whether this is the case.} \end{funcdesc} \begin{funcdesc}{pow}{x\, y\optional{\, z}} - Return \var{x} to the power \var{y}; if \var{z} is present, $x^y \bmod z$ - is returned. The arguments must have + Return \var{x} to the power \var{y}; if \var{z} is present, return + \var{x} to the power \var{y}, modulo \var{z} (computed more + efficiently that \code{pow(\var{x}, \var{y}) \% \var{z}}). + The arguments must have numeric types. With mixed operand types, the rules for binary arithmetic operators apply. The effective operand type is also the type of the result; if the result is not expressible in this type, the @@ -354,6 +356,14 @@ always attempt to return a string that is acceptable to \code{eval()}; its goal is to return a printable string. \end{funcdesc} +\begin{funcdesc}{tuple}{object} +Return a tuple whose items are the same and in the same order as +\var{object}'s items. If \var{object} is alread a tuple, it +is returned unchanged. For instance, \code{tuple('abc')} returns +returns \code{('a', 'b', 'c')} and \code{tuple([1, 2, 3])} returns +\code{(1, 2, 3)}. +\end{funcdesc} + \begin{funcdesc}{type}{object} % XXXJH xref to buil-in objects here? Return the type of an \var{object}. The return value is a type diff --git a/Doc/libposixfile.tex b/Doc/libposixfile.tex index 0d9cb32..346f576 100644 --- a/Doc/libposixfile.tex +++ b/Doc/libposixfile.tex @@ -92,11 +92,11 @@ All methods return \code{IOError} when the request fails. Format characters for the \code{lock()} method have the following meaning: -\begin{tableii}{|c|l|}{samp}{Format}{Meaning} - \lineii{u}{unlock the specified region} - \lineii{r}{request a read lock for the specified section} - \lineii{w}{request a write lock for the specified section} -\end{tableii} +\begin{tableiii}{|c|l|c|}{samp}{Format}{Meaning}{} + \lineiii{u}{unlock the specified region}{} + \lineiii{r}{request a read lock for the specified section}{} + \lineiii{w}{request a write lock for the specified section}{} +\end{tableiii} In addition the following modifiers can be added to the format: @@ -115,12 +115,12 @@ is for query purposes only. Format character for the \code{flags()} method have the following meaning: -\begin{tableii}{|c|l|}{samp}{Format}{Meaning} - \lineii{a}{append only flag} - \lineii{c}{close on exec flag} - \lineii{n}{no delay flag (also called non-blocking flag)} - \lineii{s}{synchronization flag} -\end{tableii} +\begin{tableiii}{|c|l|c|}{samp}{Format}{Meaning}{} + \lineiii{a}{append only flag}{} + \lineiii{c}{close on exec flag}{} + \lineiii{n}{no delay flag (also called non-blocking flag)}{} + \lineiii{s}{synchronization flag}{} +\end{tableiii} In addition the following modifiers can be added to the format: diff --git a/Doc/libthread.tex b/Doc/libthread.tex index c836615..4208c2d 100644 --- a/Doc/libthread.tex +++ b/Doc/libthread.tex @@ -7,7 +7,9 @@ threads of control sharing their global data space. For synchronization, simple locks (a.k.a. \dfn{mutexes} or \dfn{binary semaphores}) are provided. -The module is optional and supported on SGI and Sun Sparc systems only. +The module is optional and supported on SGI IRIX 4.x and 5.x and Sun +Solaris 2.x systems, as well as on systems that have a PTHREAD +implementation (e.g. KSR). It defines the following constant and functions: @@ -41,6 +43,14 @@ Return a new lock object. Methods of locks are described below. The lock is initially unlocked. \end{funcdesc} +\begin{funcdesc}{get_ident}{} +Return the `thread identifier' of the current thread. This is a +nonzero integer. Its value has no direct meaning; it is intended as a +magic cookie to be used e.g. to index a dictionary of thread-specific +data. Thread identifiers may be recycled when a thread exits and +another thread is created. +\end{funcdesc} + Lock objects have the following methods: \renewcommand{\indexsubitem}{(lock method)} diff --git a/Doc/myformat.perl b/Doc/myformat.perl index a2130b1..bfb4821 100644 --- a/Doc/myformat.perl +++ b/Doc/myformat.perl @@ -19,6 +19,7 @@ sub do_cmd_ABC{ join('', 'ABC', @_[0]); } sub do_cmd_UNIX{ join('', 'Unix', @_[0]); } sub do_cmd_ASCII{ join('', 'ASCII', @_[0]); } sub do_cmd_C{ join('', 'C', @_[0]); } +sub do_cmd_Cpp{ join('', 'C++', @_[0]); } sub do_cmd_EOF{ join('', 'EOF', @_[0]); } # texinfo-like formatting commands: \code{...} etc. |