diff --git a/man3/matherr.3 b/man3/matherr.3
index 5c4f87114..fdadc7007 100644
--- a/man3/matherr.3
+++ b/man3/matherr.3
@@ -38,6 +38,20 @@ matherr \- SVID math library exception handling
 .PP
 Link with \fI\-lm\fP.
 .SH DESCRIPTION
+.IR Note :
+the mechanism described in this page is no longer supported by glibc.
+Before glibc 2.27, it had been marked as obsolete.
+Since glibc 2.27,
+.\" glibc commit 813378e9fe17e029caf627cab76fe23eb46815fa
+the mechanism has been removed altogether.
+New applications should use the techniques described in
+.BR math_error (7)
+and
+.BR fenv (3).
+This page documents the
+.BR matherr ()
+mechanism as an aid for maintaining and porting older applications.
+.PP
 The System V Interface Definition (SVID) specifies that various
 math functions should invoke a function called
 .BR matherr ()
@@ -48,17 +62,6 @@ after
 returns, the system then returns to the math function,
 which in turn returns to the caller.
 .PP
-The
-.BR matherr ()
-mechanism is supported by glibc, but is now obsolete:
-new applications should use the techniques described in
-.BR math_error (7)
-and
-.BR fenv (3).
-This page documents the glibc
-.BR matherr ()
-mechanism as an aid for maintaining and porting older applications.
-.PP
 To employ
 .BR matherr (),
 the programmer must define the