matherr.3: Note that glibc 2.27 removes the 'matherr' mechanism

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2017-08-23 12:36:40 +02:00
parent d4f849a29d
commit 73593f0d3b
1 changed files with 14 additions and 11 deletions

View File

@ -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