Clarify impending deprecation of the floor div operator, modulo operator,

and divmod() function for complex numbers.

Closes SF Bug 621708: Unclear deprecation.

diff --git a/Doc/ref/ref5.tex b/Doc/ref/ref5.tex
index 2890c5bf17a0116e10b04463f455f31fe2191f04..abe9f097fc887ca95381e1bd3cea83aefcc41adc 100644 (file)
--- a/Doc/ref/ref5.tex
+++ b/Doc/ref/ref5.tex
@@ -716,11 +716,10 @@ approximately where \code{x/y} is replaced by \code{floor(x/y)}) or
     * 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.}
+\deprecated{2.3}{The floor division operator, the modulo operator,
+and the \function{divmod()} function are no longer defined for complex
+numbers.  Instead, convert to a floating point number using the
+\function{abs()} function if appropriate.}
 
 The \code{+} (addition) operator yields the sum of its arguments.
 The arguments must either both be numbers or both sequences of the