diff --git a/man3/des_crypt.3 b/man3/des_crypt.3
index 3ce5aaac5..dcda3a428 100644
--- a/man3/des_crypt.3
+++ b/man3/des_crypt.3
@@ -131,6 +131,17 @@ is false only for the first two statuses.
 .SH VERSIONS
 These functions are present in
 glibc 2.1 and later.
+.SH VERSIONS
+Because they employ the DES block cipher,
+which is no longer considered secure,
+.BR ecb_crypt (),
+.BR ecb_crypt (),
+.BR crypt_r (),
+and
+.BR des_setparity ()
+were removed in glibc 2.28.
+Applications should switch to a modern cryptography library, such as
+.BR libgcrypt .
 .SH ATTRIBUTES
 For an explanation of the terms used in this section, see
 .BR attributes (7).
diff --git a/man3/encrypt.3 b/man3/encrypt.3
index b5f6c9ec2..7ef6256e6 100644
--- a/man3/encrypt.3
+++ b/man3/encrypt.3
@@ -119,6 +119,17 @@ On success, it is unchanged.
 .B ENOSYS
 The function is not provided.
 (For example because of former USA export restrictions.)
+.SH VERSIONS
+Because they employ the DES block cipher,
+which is no longer considered secure,
+.BR crypt (),
+.BR crypt_r (),
+.BR setkey (),
+and
+.BR setkey_r ()
+were removed in glibc 2.28.
+Applications should switch to a modern cryptography library, such as
+.BR libgcrypt .
 .SH ATTRIBUTES
 For an explanation of the terms used in this section, see
 .BR attributes (7).