Added copyright.tex to all files.
Added descr of check_interval to libsys.tex.
Corrected lotsa typos in tut.tex (thanks to George M. Sipe).
Corrected mktuple (should be newtupleobject) example in ext.tex.
--- /dev/null
+\author{
+ Guido van Rossum \\
+ Dept. CST, CWI, P.O. Box 94079 \\
+ 1090 GB Amsterdam, The Netherlands \\
+ E-mail: {\tt guido@cwi.nl}
+}
+
+\date{6 Oct 1994 \\ Release 1.1} % XXX update before release!
--- /dev/null
+Copyright 1991, 1992, 1993, 1994 by Stichting Mathematisch Centrum,
+Amsterdam, The Netherlands.
+
+\begin{center}
+All Rights Reserved
+\end{center}
+
+Permission to use, copy, modify, and distribute this software and its
+documentation for any purpose and without fee is hereby granted,
+provided that the above copyright notice appear in all copies and that
+both that copyright notice and this permission notice appear in
+supporting documentation, and that the names of Stichting Mathematisch
+Centrum or CWI not be used in advertising or publicity pertaining to
+distribution of the software without specific, written prior permission.
+
+STICHTING MATHEMATISCH CENTRUM DISCLAIMS ALL WARRANTIES WITH REGARD TO
+THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH CENTRUM BE LIABLE
+FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
+OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
\title{Extending and Embedding the Python Interpreter}
-\author{
- Guido van Rossum \\
- Dept. CST, CWI, P.O. Box 94079 \\
- 1090 GB Amsterdam, The Netherlands \\
- E-mail: {\tt guido@cwi.nl}
-}
-
-\date{14 July 1994 \\ Release 1.0.3} % XXX update before release!
+\input{boilerplate}
% Tell \index to actually write the .idx file
\makeindex
\maketitle
+\input{copyright}
+
\begin{abstract}
\noindent
object *result;
...
/* Time to call the callback */
- arglist = mktuple(0);
+ arglist = newtupleobject(0);
result = call_object(my_callback, arglist);
DECREF(arglist);
\end{verbatim}
\title{Extending and Embedding the Python Interpreter}
-\author{
- Guido van Rossum \\
- Dept. CST, CWI, P.O. Box 94079 \\
- 1090 GB Amsterdam, The Netherlands \\
- E-mail: {\tt guido@cwi.nl}
-}
-
-\date{14 July 1994 \\ Release 1.0.3} % XXX update before release!
+\input{boilerplate}
% Tell \index to actually write the .idx file
\makeindex
\maketitle
+\input{copyright}
+
\begin{abstract}
\noindent
object *result;
...
/* Time to call the callback */
- arglist = mktuple(0);
+ arglist = newtupleobject(0);
result = call_object(my_callback, arglist);
DECREF(arglist);
\end{verbatim}
\title{Python Library Reference}
-\author{
- Guido van Rossum \\
- Dept. CST, CWI, P.O. Box 94079 \\
- 1090 GB Amsterdam, The Netherlands \\
- E-mail: {\tt guido@cwi.nl}
-}
-
-\date{14 July 1994 \\ Release 1.0.3} % XXX update before release!
+\input{boilerplate}
\makeindex % tell \index to actually write the .idx file
\maketitle
+\input{copyright}
+
\begin{abstract}
\noindent
\title{Python Library Reference}
-\author{
- Guido van Rossum \\
- Dept. CST, CWI, P.O. Box 94079 \\
- 1090 GB Amsterdam, The Netherlands \\
- E-mail: {\tt guido@cwi.nl}
-}
-
-\date{14 July 1994 \\ Release 1.0.3} % XXX update before release!
+\input{boilerplate}
\makeindex % tell \index to actually write the .idx file
\maketitle
+\input{copyright}
+
\begin{abstract}
\noindent
modules.)
\end{datadesc}
+\begin{datadesc}{check_interval}
+When this variable is set to an integer value, it determines how often
+the interpreter checks for periodic things such as thread switches and
+signal handlers. The default is 10, meaning the check is performed
+every 10 Python virtual instructions. Setting this to a large value
+may increase performance for programs using threads. Setting it to a
+value <= 0 checks every virtual instruction, maximizing responsiveness
+as well as overhead.
+
\begin{datadesc}{exc_type}
\dataline{exc_value}
\dataline{exc_traceback}
modules.)
\end{datadesc}
+\begin{datadesc}{check_interval}
+When this variable is set to an integer value, it determines how often
+the interpreter checks for periodic things such as thread switches and
+signal handlers. The default is 10, meaning the check is performed
+every 10 Python virtual instructions. Setting this to a large value
+may increase performance for programs using threads. Setting it to a
+value <= 0 checks every virtual instruction, maximizing responsiveness
+as well as overhead.
+
\begin{datadesc}{exc_type}
\dataline{exc_value}
\dataline{exc_traceback}
\title{Python Reference Manual}
-\author{
- Guido van Rossum \\
- Dept. CST, CWI, P.O. Box 94079 \\
- 1090 GB Amsterdam, The Netherlands \\
- E-mail: {\tt guido@cwi.nl}
-}
-
-\date{14 July 1994 \\ Release 1.0.3} % XXX update before release!
+\input{boilerplate}
% Tell \index to actually write the .idx file
\makeindex
\maketitle
+\input{copyright}
+
\begin{abstract}
\noindent
\title{Python Reference Manual}
-\author{
- Guido van Rossum \\
- Dept. CST, CWI, P.O. Box 94079 \\
- 1090 GB Amsterdam, The Netherlands \\
- E-mail: {\tt guido@cwi.nl}
-}
-
-\date{14 July 1994 \\ Release 1.0.3} % XXX update before release!
+\input{boilerplate}
% Tell \index to actually write the .idx file
\makeindex
\maketitle
+\input{copyright}
+
\begin{abstract}
\noindent
--- /dev/null
+\author{
+ Guido van Rossum \\
+ Dept. CST, CWI, P.O. Box 94079 \\
+ 1090 GB Amsterdam, The Netherlands \\
+ E-mail: {\tt guido@cwi.nl}
+}
+
+\date{6 Oct 1994 \\ Release 1.1} % XXX update before release!
--- /dev/null
+Copyright 1991, 1992, 1993, 1994 by Stichting Mathematisch Centrum,
+Amsterdam, The Netherlands.
+
+\begin{center}
+All Rights Reserved
+\end{center}
+
+Permission to use, copy, modify, and distribute this software and its
+documentation for any purpose and without fee is hereby granted,
+provided that the above copyright notice appear in all copies and that
+both that copyright notice and this permission notice appear in
+supporting documentation, and that the names of Stichting Mathematisch
+Centrum or CWI not be used in advertising or publicity pertaining to
+distribution of the software without specific, written prior permission.
+
+STICHTING MATHEMATISCH CENTRUM DISCLAIMS ALL WARRANTIES WITH REGARD TO
+THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH CENTRUM BE LIABLE
+FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
+OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
\documentstyle[twoside,11pt,myformat]{report}
\title{Python Tutorial}
-
-\author{
- Guido van Rossum \\
- Dept. CST, CWI, P.O. Box 94079 \\
- 1090 GB Amsterdam, The Netherlands \\
- E-mail: {\tt guido@cwi.nl}
-}
-\date{14 July 1994 \\ Release 1.0.3} % XXX update before release!
+\input{boilerplate}
\begin{document}
\maketitle
+\input{copyright}
+
\begin{abstract}
\noindent
\item
The {\tt while} loop executes as long as the condition (here: {\tt b <
-100}) remains true. In Python, like in C, any non-zero integer value is
+10}) remains true. In Python, like in C, any non-zero integer value is
true; zero is false. The condition may also be a string or list value,
in fact any sequence; anything with a non-zero length is true, empty
sequences are false. The test used in the example is a simple
The {\tt print} statement writes the value of the expression(s) it is
given. It differs from just writing the expression you want to write
(as we did earlier in the calculator examples) in the way it handles
-multiple expressions and strings. Strings are written without quotes,
+multiple expressions and strings. Strings are printed without quotes,
and a space is inserted between items, so you can format things nicely,
like this:
\bcode\begin{verbatim}
>>> def fib(n): # write Fibonacci series up to n
... a, b = 0, 1
-... while b <= n:
+... while b < n:
... print b,
... a, b = b, a+b
...
>>> def fib2(n): # return Fibonacci series up to n
... result = []
... a, b = 0, 1
-... while b <= n:
+... while b < n:
... result.append(b) # see below
... a, b = b, a+b
... return result
have the same priority, which is lower than that of all numerical
operators.
-Comparisons can be chained: e.g., {\tt a < b = c} tests whether {\tt a}
+Comparisons can be chained: e.g., {\tt a < b == c} tests whether {\tt a}
is less than {\tt b} and moreover {\tt b} equals {\tt c}.
Comparisons may be combined by the Boolean operators {\tt and} and {\tt
def fib(n): # write Fibonacci series up to n
a, b = 0, 1
- while b <= n:
+ while b < n:
print b,
a, b = b, a+b
def fib2(n): # return Fibonacci series up to n
result = []
a, b = 0, 1
- while b <= n:
+ while b < n:
result.append(b)
a, b = b, a+b
return result
built-in names (functions such as \verb\abs()\, and built-in exception
names); the global names in a module; and the local names in a
function invocation. In a sense the set of attributes of an object
-also form a name space. The important things to know about name
+also form a name space. The important thing to know about name
spaces is that there is absolutely no relation between names in
different name spaces; for instance, two different modules may both
define a function ``maximize'' without confusion --- users of the
containing built-in names.
Usually, the local scope references the local names of the (textually)
-current function. Outside functions, the the local scope references
+current function. Outside of functions, the the local scope references
the same name space as the global scope: the module's name space.
Class definitions place yet another name space in the local scope.
thoroughly revised, several new features have been added to the
language. While ideally I should revise the tutorial to incorporate
them in the mainline of the text, lack of time currently requires me
-to follow a more modest approach. In this chapter I will briefly list the
+to take a more modest approach. In this chapter I will briefly list the
most important improvements to the language and how you can use them
to your benefit.
\section{Generalized Dictionaries}
The keys of dictionaries are no longer restricted to strings -- they
-can be numbers, tuples, or (certain) class instances. (Lists and
+can be
+any immutable basic type including strings,
+numbers, tuples, or (certain) class instances. (Lists and
dictionaries are not acceptable as dictionary keys, in order to avoid
problems when the object used as a key is modified.)
\section{Miscellaneous New Built-in Functions}
The function \verb\vars()\ returns a dictionary containing the current
-local variables. With a module as argument, it returns that module's
+local variables. With a module argument, it returns that module's
global variables. The old function \verb\dir(x)\ returns
\verb\vars(x).keys()\.
\documentstyle[twoside,11pt,myformat]{report}
\title{Python Tutorial}
-
-\author{
- Guido van Rossum \\
- Dept. CST, CWI, P.O. Box 94079 \\
- 1090 GB Amsterdam, The Netherlands \\
- E-mail: {\tt guido@cwi.nl}
-}
-\date{14 July 1994 \\ Release 1.0.3} % XXX update before release!
+\input{boilerplate}
\begin{document}
\maketitle
+\input{copyright}
+
\begin{abstract}
\noindent
\item
The {\tt while} loop executes as long as the condition (here: {\tt b <
-100}) remains true. In Python, like in C, any non-zero integer value is
+10}) remains true. In Python, like in C, any non-zero integer value is
true; zero is false. The condition may also be a string or list value,
in fact any sequence; anything with a non-zero length is true, empty
sequences are false. The test used in the example is a simple
The {\tt print} statement writes the value of the expression(s) it is
given. It differs from just writing the expression you want to write
(as we did earlier in the calculator examples) in the way it handles
-multiple expressions and strings. Strings are written without quotes,
+multiple expressions and strings. Strings are printed without quotes,
and a space is inserted between items, so you can format things nicely,
like this:
\bcode\begin{verbatim}
>>> def fib(n): # write Fibonacci series up to n
... a, b = 0, 1
-... while b <= n:
+... while b < n:
... print b,
... a, b = b, a+b
...
>>> def fib2(n): # return Fibonacci series up to n
... result = []
... a, b = 0, 1
-... while b <= n:
+... while b < n:
... result.append(b) # see below
... a, b = b, a+b
... return result
have the same priority, which is lower than that of all numerical
operators.
-Comparisons can be chained: e.g., {\tt a < b = c} tests whether {\tt a}
+Comparisons can be chained: e.g., {\tt a < b == c} tests whether {\tt a}
is less than {\tt b} and moreover {\tt b} equals {\tt c}.
Comparisons may be combined by the Boolean operators {\tt and} and {\tt
def fib(n): # write Fibonacci series up to n
a, b = 0, 1
- while b <= n:
+ while b < n:
print b,
a, b = b, a+b
def fib2(n): # return Fibonacci series up to n
result = []
a, b = 0, 1
- while b <= n:
+ while b < n:
result.append(b)
a, b = b, a+b
return result
built-in names (functions such as \verb\abs()\, and built-in exception
names); the global names in a module; and the local names in a
function invocation. In a sense the set of attributes of an object
-also form a name space. The important things to know about name
+also form a name space. The important thing to know about name
spaces is that there is absolutely no relation between names in
different name spaces; for instance, two different modules may both
define a function ``maximize'' without confusion --- users of the
containing built-in names.
Usually, the local scope references the local names of the (textually)
-current function. Outside functions, the the local scope references
+current function. Outside of functions, the the local scope references
the same name space as the global scope: the module's name space.
Class definitions place yet another name space in the local scope.
thoroughly revised, several new features have been added to the
language. While ideally I should revise the tutorial to incorporate
them in the mainline of the text, lack of time currently requires me
-to follow a more modest approach. In this chapter I will briefly list the
+to take a more modest approach. In this chapter I will briefly list the
most important improvements to the language and how you can use them
to your benefit.
\section{Generalized Dictionaries}
The keys of dictionaries are no longer restricted to strings -- they
-can be numbers, tuples, or (certain) class instances. (Lists and
+can be
+any immutable basic type including strings,
+numbers, tuples, or (certain) class instances. (Lists and
dictionaries are not acceptable as dictionary keys, in order to avoid
problems when the object used as a key is modified.)
\section{Miscellaneous New Built-in Functions}
The function \verb\vars()\ returns a dictionary containing the current
-local variables. With a module as argument, it returns that module's
+local variables. With a module argument, it returns that module's
global variables. The old function \verb\dir(x)\ returns
\verb\vars(x).keys()\.
projects / thirdparty / Python / cpython.git / commitdiff
