diff --git a/man2/stime.2 b/man2/stime.2
index 78c4767c1..a05ae5c42 100644
--- a/man2/stime.2
+++ b/man2/stime.2
@@ -46,6 +46,12 @@ Feature Test Macro Requirements for glibc (see
     Glibc 2.19 and earlier:
         _SVID_SOURCE
 .SH DESCRIPTION
+.BR NOTE :
+This function is deprecated;
+use
+.BR clock_settime (2)
+instead.
+.PP
 .BR stime ()
 sets the system's idea of the time and date.
 The time, pointed
@@ -70,6 +76,11 @@ Under Linux, the
 privilege is required.
 .SH CONFORMING TO
 SVr4.
+.SH NOTES
+Starting with glibc 2.31,
+this function is no longer available to newly linked applications
+and is no longer declared in
+.R <time.h> .
 .SH SEE ALSO
 .BR date (1),
 .BR settimeofday (2),