Mailing List Archive

python/dist/src/Doc/ref ref5.tex,1.53.4.6,1.53.4.7
Update of /cvsroot/python/python/dist/src/Doc/ref
In directory usw-pr-cvs1:/tmp/cvs-serv11196

Modified Files:
Tag: release22-maint
ref5.tex
Log Message:
Backport 1.61 (note, the actual deprecation is not backported since it
could affect existing code; instead, the documentation of the deprecation
is being backported to provide maximum advance notice):

Patch 543387. Document deprecation of complex %, //,and divmod().



Index: ref5.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/ref/ref5.tex,v
retrieving revision 1.53.4.6
retrieving revision 1.53.4.7
diff -C2 -d -r1.53.4.6 -r1.53.4.7
*** ref5.tex 25 Jun 2002 04:00:24 -0000 1.53.4.6
--- ref5.tex 5 Oct 2002 06:51:34 -0000 1.53.4.7
***************
*** 706,710 ****
modulo are also connected with the built-in function \function{divmod()}:
\code{divmod(x, y) == (x/y, x\%y)}. These identities don't hold for
! floating point and complex numbers; there similar identities hold
approximately where \code{x/y} is replaced by \code{floor(x/y)}) or
\code{floor(x/y) - 1} (for floats),\footnote{
--- 706,710 ----
modulo are also connected with the built-in function \function{divmod()}:
\code{divmod(x, y) == (x/y, x\%y)}. These identities don't hold for
! floating point numbers; there similar identities hold
approximately where \code{x/y} is replaced by \code{floor(x/y)}) or
\code{floor(x/y) - 1} (for floats),\footnote{
***************
*** 714,719 ****
the latter result, in order to preserve that \code{divmod(x,y)[0]
* y + x \%{} y} be very close to \code{x}.
! } or \code{floor((x/y).real)} (for
! complex).

The \code{+} (addition) operator yields the sum of its arguments.
--- 714,724 ----
the latter result, in order to preserve that \code{divmod(x,y)[0]
* y + x \%{} y} be very close to \code{x}.
! }.
!
! Complex floor division operator, modulo operator, and
! \function{divmod()}.
!
! \deprecated{2.3}{Instead convert to float using \function{abs()}
! if appropriate.}

The \code{+} (addition) operator yields the sum of its arguments.