Clarify 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 ef6cba904711223977aa9cde0022df3356f4e690..f554ab49d18b549264676fcdc74050caf9d886a3 100644 (file)
--- a/Doc/ref/ref5.tex
+++ b/Doc/ref/ref5.tex
@@ -700,11 +700,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