# DP: document deprecated syntax for arithmetic evaluation.

--- a/bash/doc/bash.1
+++ b/bash/doc/bash.1
@@ -2994,6 +2994,9 @@
 \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
