[Python-checkins] python/dist/src/Doc/ref ref5.tex,1.53.4.6,1.53.4.7

[rhettinger@users.sourceforge.net]

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.