[Python-checkins] CVS: python/dist/src/Doc/ref ref2.tex,1.17,1.18 ref3.tex,1.39,1.40 ref4.tex,1.21,1.22 ref5.tex,1.27,1.28 ref7.tex,1.18,1.19

Fred Drake python-dev@python.org
Mon, 3 Apr 2000 00:41:21 -0400


Update of /projects/cvsroot/python/dist/src/Doc/ref
In directory seahag.cnri.reston.va.us:/home/fdrake/projects/python/Doc/ref

Modified Files:
	ref2.tex ref3.tex ref4.tex ref5.tex ref7.tex 
Log Message:

Merged changes from the 1.5.2p2 release.


Index: ref2.tex
===================================================================
RCS file: /projects/cvsroot/python/dist/src/Doc/ref/ref2.tex,v
retrieving revision 1.17
retrieving revision 1.18
diff -C2 -r1.17 -r1.18
*** ref2.tex	1999/03/05 18:30:21	1.17
--- ref2.tex	2000/04/03 04:41:18	1.18
***************
*** 149,153 ****
  
  A formfeed character may be present at the start of the line; it will
! be ignored for the indentation calculations above.  A formfeed
  characters occurring elsewhere in the leading whitespace have an
  undefined effect (for instance, they may reset the space count to
--- 149,153 ----
  
  A formfeed character may be present at the start of the line; it will
! be ignored for the indentation calculations above.  Formfeed
  characters occurring elsewhere in the leading whitespace have an
  undefined effect (for instance, they may reset the space count to
***************
*** 370,374 ****
  backslashes).  Specifically, \emph{a raw string cannot end in a single
  backslash} (since the backslash would escape the following quote
! character).
  
  \subsection{String literal concatenation\label{string-catenation}}
--- 370,376 ----
  backslashes).  Specifically, \emph{a raw string cannot end in a single
  backslash} (since the backslash would escape the following quote
! character).  Note also that a single backslash followed by a newline
! is interpreted as those two characters as part of the string,
! \emph{not} as a line continuation.
  
  \subsection{String literal concatenation\label{string-catenation}}
***************
*** 465,469 ****
  
  Note that the integer part of a floating point number cannot look like
! an octal integer.
  The allowed range of floating point literals is
  implementation-dependent.
--- 467,473 ----
  
  Note that the integer part of a floating point number cannot look like
! an octal integer, though the exponent may look like an octal literal
! but will always be interpreted using radix 10.  For example,
! \samp{1e010} is legal, while \samp{07.1} is a syntax error.
  The allowed range of floating point literals is
  implementation-dependent.
***************
*** 486,490 ****
  \end{verbatim}
  
! An imaginary literals yields a complex number with a real part of
  0.0.  Complex numbers are represented as a pair of floating point
  numbers and have the same restrictions on their range.  To create a
--- 490,494 ----
  \end{verbatim}
  
! An imaginary literal yields a complex number with a real part of
  0.0.  Complex numbers are represented as a pair of floating point
  numbers and have the same restrictions on their range.  To create a
***************
*** 523,527 ****
  
  The period can also occur in floating-point and imaginary literals.  A
! sequence of three periods has a special meaning as ellipses in slices.
  
  The following printing ASCII characters have special meaning as part
--- 527,531 ----
  
  The period can also occur in floating-point and imaginary literals.  A
! sequence of three periods has a special meaning as an ellipsis in slices.
  
  The following printing ASCII characters have special meaning as part

Index: ref3.tex
===================================================================
RCS file: /projects/cvsroot/python/dist/src/Doc/ref/ref3.tex,v
retrieving revision 1.39
retrieving revision 1.40
diff -C2 -r1.39 -r1.40
*** ref3.tex	1999/11/10 16:13:25	1.39
--- ref3.tex	2000/04/03 04:41:18	1.40
***************
*** 145,149 ****
  numbers are of course strongly related to mathematical numbers, but
  subject to the limitations of numerical representation in computers.
- \obindex{number}
  \obindex{numeric}
  
--- 145,148 ----
***************
*** 163,167 ****
  (The range may be larger on machines with a larger natural word
  size, but not smaller.)
! When the result of an operation falls outside this range, the
  exception \exception{OverflowError} is raised.
  For the purpose of shift and mask operations, integers are assumed to
--- 162,166 ----
  (The range may be larger on machines with a larger natural word
  size, but not smaller.)
! When the result of an operation would fall outside this range, the
  exception \exception{OverflowError} is raised.
  For the purpose of shift and mask operations, integers are assumed to
***************
*** 222,226 ****
  index set contains the numbers 0, 1, \ldots, \var{n}-1.  Item
  \var{i} of sequence \var{a} is selected by \code{\var{a}[\var{i}]}.
! \obindex{seqence}
  \index{index operation}
  \index{item selection}
--- 221,225 ----
  index set contains the numbers 0, 1, \ldots, \var{n}-1.  Item
  \var{i} of sequence \var{a} is selected by \code{\var{a}[\var{i}]}.
! \obindex{sequence}
  \index{index operation}
  \index{item selection}
***************
*** 619,623 ****
  they have methods with certain special names.  See
  section \ref{specialnames}, ``Special method names.''
! \obindex{number}
  \obindex{sequence}
  \obindex{mapping}
--- 618,622 ----
  they have methods with certain special names.  See
  section \ref{specialnames}, ``Special method names.''
! \obindex{numeric}
  \obindex{sequence}
  \obindex{mapping}
***************
*** 703,715 ****
    \ttindex{co_varnames}}
  
! The following flag bits are defined for \member{co_flags}: bit 2 is set
! if the function uses the \samp{*arguments} syntax to accept an
! arbitrary number of positional arguments; bit 3 is set if the function
! uses the \samp{**keywords} syntax to accept arbitrary keyword
! arguments; other bits are used internally or reserved for future use.
! If a code object represents a function, the first item in
! \member{co_consts} is the documentation string of the
! function, or \code{None} if undefined.
! \index{documentation string}
  
  \item[Frame objects]
--- 702,713 ----
    \ttindex{co_varnames}}
  
! The following flag bits are defined for \member{co_flags}: bit
! \code{0x04} is set if the function uses the \samp{*arguments} syntax
! to accept an arbitrary number of positional arguments; bit
! \code{0x08} is set if the function uses the \samp{**keywords} syntax
! to accept arbitrary keyword arguments; other bits are used internally
! or reserved for future use.  If\index{documentation string} a code
! object represents a function, the first item in \member{co_consts} is
! the documentation string of the function, or \code{None} if undefined.
  
  \item[Frame objects]
***************
*** 1099,1106 ****
  The returned object should be of the same type as \var{self}.  Note
  that missing \var{i} or \var{j} in the slice expression are replaced
! by zero or \code{sys.maxint}, respectively, and no further
! transformations on the indices is performed.  The interpretation of
! negative indices and indices larger than the length of the sequence is
! up to the method.
  \end{methoddesc}
  
--- 1097,1107 ----
  The returned object should be of the same type as \var{self}.  Note
  that missing \var{i} or \var{j} in the slice expression are replaced
! by zero or \code{sys.maxint}, respectively.  If negative indexes are
! used in the slice, the length of the sequence is added to that index.
! If the instance does not implement the \method{__len__()} method, an
! \exception{AttributeError} is raised.
! No guarantee is made that indexes adjusted this way are not still
! negative.  Indexes which are greater than the length of the sequence
! are not modified.
  \end{methoddesc}
  

Index: ref4.tex
===================================================================
RCS file: /projects/cvsroot/python/dist/src/Doc/ref/ref4.tex,v
retrieving revision 1.21
retrieving revision 1.22
diff -C2 -r1.21 -r1.22
*** ref4.tex	1999/05/13 18:38:11	1.21
--- ref4.tex	2000/04/03 04:41:18	1.22
***************
*** 184,192 ****
  executed whether an exception occurred or not in the preceding code.
  
! Python uses the ``termination'' model of error handling: an exception
! handler can find out what happened and continue execution at an outer
! level, but it cannot repair the cause of the error and retry the
! failing operation (except by re-entering the offending piece of
! code from the top).
  
  When an exception is not handled at all, the interpreter terminates
--- 184,192 ----
  executed whether an exception occurred or not in the preceding code.
  
! Python uses the ``termination'' \index{termination model}model of
! error handling: an exception handler can find out what happened and
! continue execution at an outer level, but it cannot repair the cause
! of the error and retry the failing operation (except by re-entering
! the offending piece of code from the top).
  
  When an exception is not handled at all, the interpreter terminates
***************
*** 211,214 ****
  being raised.
  
! See also the description of the \keyword{try} and \keyword{raise}
! statements in chapter \ref{compound}.
--- 211,214 ----
  being raised.
  
! See also the description of the \keyword{try} statement in section
! \ref{try} and \keyword{raise} statement in section \ref{raise}.

Index: ref5.tex
===================================================================
RCS file: /projects/cvsroot/python/dist/src/Doc/ref/ref5.tex,v
retrieving revision 1.27
retrieving revision 1.28
diff -C2 -r1.27 -r1.28
*** ref5.tex	1999/05/06 14:46:35	1.27
--- ref5.tex	2000/04/03 04:41:18	1.28
***************
*** 116,120 ****
  the same object or a different object with the same value.
  \indexiii{immutable}{data}{type}
! \indexii{immutable}{objects}
  
  \subsection{Parenthesized forms\label{parenthesized}}
--- 116,120 ----
  the same object or a different object with the same value.
  \indexiii{immutable}{data}{type}
! \indexii{immutable}{object}
  
  \subsection{Parenthesized forms\label{parenthesized}}
***************
*** 190,194 ****
  are not detected; the last datum (textually rightmost in the display)
  stored for a given key value prevails.
! \indexii{immutable}{objects}
  
  \subsection{String conversions\label{string-conversions}}
--- 190,194 ----
  are not detected; the last datum (textually rightmost in the display)
  stored for a given key value prevails.
! \indexii{immutable}{object}
  
  \subsection{String conversions\label{string-conversions}}
***************
*** 339,343 ****
  evaluate to a sequence object.  The lower and upper bound expressions,
  if present, must evaluate to plain integers; defaults are zero and the
! sequence's length, respectively.  If either bound is negative, the
  sequence's length is added to it.  The slicing now selects all items
  with index \var{k} such that
--- 339,343 ----
  evaluate to a sequence object.  The lower and upper bound expressions,
  if present, must evaluate to plain integers; defaults are zero and the
! \code{sys.maxint}, respectively.  If either bound is negative, the
  sequence's length is added to it.  The slicing now selects all items
  with index \var{k} such that
***************
*** 508,512 ****
  
  
! \section{Unary arithmetic operations\label{unary}}
  \indexiii{unary}{arithmetic}{operation}
  \indexiii{unary}{bit-wise}{operation}
--- 508,512 ----
  
  
! \section{Unary arithmetic operations \label{unary}}
  \indexiii{unary}{arithmetic}{operation}
  \indexiii{unary}{bit-wise}{operation}
***************
*** 527,531 ****
  \index{plus}
  
! The unary \code{~} (invert) operator yields the bit-wise inversion
  of its plain or long integer argument.  The bit-wise inversion of
  \code{x} is defined as \code{-(x+1)}.  It only applies to integral
--- 527,531 ----
  \index{plus}
  
! The unary \code{\~} (invert) operator yields the bit-wise inversion
  of its plain or long integer argument.  The bit-wise inversion of
  \code{x} is defined as \code{-(x+1)}.  It only applies to integral

Index: ref7.tex
===================================================================
RCS file: /projects/cvsroot/python/dist/src/Doc/ref/ref7.tex,v
retrieving revision 1.18
retrieving revision 1.19
diff -C2 -r1.18 -r1.19
*** ref7.tex	1999/08/24 22:14:01	1.18
--- ref7.tex	2000/04/03 04:41:18	1.19
***************
*** 307,313 ****
  parameter has a default value, all following parameters must also have
  a default value --- this is a syntactic restriction that is not
! expressed by the grammar.\footnote{
! Currently this is not checked; instead, \code{def f(a=1, b)} is
! interpreted as \code{def f(a=1, b=None)}.}
  \indexiii{default}{parameter}{value}
  
--- 307,311 ----
  parameter has a default value, all following parameters must also have
  a default value --- this is a syntactic restriction that is not
! expressed by the grammar.
  \indexiii{default}{parameter}{value}