# DP: document deprecated syntax for arithmetic evaluation.

--- a/doc/bash.1
+++ b/doc/bash.1
@@ -3481,6 +3481,9 @@ and the substitution of the result.  The
 \fB$((\fP\fIexpression\fP\fB))\fP
 .RE
 .PP
+The old format \fB$[\fP\fIexpression\fP\fB]\fP is deprecated and will
+be removed in upcoming versions of bash.
+.PP
 The
 .I expression
 is treated as if it were within double quotes, but a double quote