diff --git a/man3/pthread_yield.3 b/man3/pthread_yield.3
index 0b67d3a5e..642ea1176 100644
--- a/man3/pthread_yield.3
+++ b/man3/pthread_yield.3
@@ -35,6 +35,9 @@ pthread_yield \- yield the processor
 .PP
 Compile and link with \fI\-pthread\fP.
 .SH DESCRIPTION
+.BR Note :
+This function is deprecated; see below.
+.PP
 .BR pthread_yield ()
 causes the calling thread to relinquish the CPU.
 The thread is placed at the end of the run queue for its static
@@ -50,6 +53,8 @@ on error, it returns an error number.
 On Linux, this call always succeeds
 (but portable and future-proof applications should nevertheless
 handle a possible error return).
+.SH VERSIONS
+Since glibc 2.34, this function is marked as deprecated.
 .SH ATTRIBUTES
 For an explanation of the terms used in this section, see
 .BR attributes (7).