[Python-checkins] CVS: python/dist/src/Doc/lib libfuncs.tex,1.79,1.80

[Guido van Rossum]

Update of /cvsroot/python/python/dist/src/Doc/lib
In directory usw-pr-cvs1:/tmp/cvs-serv5779

Modified Files:
	libfuncs.tex 
Log Message:
On int/long to the negative int/long power, let float handle it
instead of raising an error.  This was one of the two issues that the
VPython folks were particularly problematic for their students.  (The
other one was integer division...)  This implements (my) SF patch
#440487.


Index: libfuncs.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libfuncs.tex,v
retrieving revision 1.79
retrieving revision 1.80
diff -C2 -r1.79 -r1.80
*** libfuncs.tex	2001/07/06 19:28:48	1.79
--- libfuncs.tex	2001/07/12 11:27:16	1.80
***************
*** 495,505 ****
    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 than \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
!   function raises an exception; for example, \code{pow(2, -1)} or
!   \code{pow(2, 35000)} is not allowed.
  \end{funcdesc}
  
--- 495,508 ----
    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 than \code{pow(\var{x}, \var{y}) \%\ \var{z}}).  The
!   arguments must have numeric types.  With mixed operand types, the
!   coercion rules for binary arithmetic operators apply.  For int and
!   long int operands, the result has the same type as the operands
!   (after coercion) unless the second argument is negative; in that
!   case, all arguments are converted to float and a float result is
!   delivered.  For example, \code{10**2} returns \code{100}, but
!   \code{10**-2} returns \code{0.01}.  (This last feature was added in
!   Python 2.2.  In Python 2.1 and before, a negative second argument
!   would raise an exception.)
  \end{funcdesc}