err.3: EXAMPLES: use EXIT_FAILURE rather than 1 as exit status

[thirdparty/man-pages.git] / man3 / fabs.3

diff --git a/man3/fabs.3 b/man3/fabs.3
index c2ae6f30f83ece87adf2183461863ee1f72db037..033f64075a5469b1fd7225af7746d008f3f21338 100644 (file)
--- a/man3/fabs.3
+++ b/man3/fabs.3
@@ -1,5 +1,6 @@
 .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
@@ -19,6 +20,7 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
 .\" References consulted:
 .\"     Linux libc source code
@@ -27,37 +29,80 @@
 .\" Modified Sat Jul 24 19:42:04 1993 by Rik Faith (faith@cs.unc.edu)
 .\" Added fabsl, fabsf, aeb, 2001-06-07
 .\"
-.TH FABS 3  2001-06-07 "" "Linux Programmer's Manual"
+.TH FABS 3  2017-09-15 "" "Linux Programmer's Manual"
 .SH NAME
 fabs, fabsf, fabsl \- absolute value of floating-point number
 .SH SYNOPSIS
 .nf
 .B #include <math.h>
-.sp
+.PP
 .BI "double fabs(double " x );
-.br
 .BI "float fabsf(float " x );
-.br
 .BI "long double fabsl(long double " x );
 .fi
-.sp
-Link with \-lm.
+.PP
+Link with \fI\-lm\fP.
+.PP
+.in -4n
+Feature Test Macro Requirements for glibc (see
+.BR feature_test_macros (7)):
+.in
+.PP
+.ad l
+.BR fabsf (),
+.BR fabsl ():
+.RS 4
+_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L
+    || /* Since glibc 2.19: */ _DEFAULT_SOURCE
+    || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
+.RE
+.ad b
 .SH DESCRIPTION
-The
-.BR fabs ()
-functions return the absolute value of the floating-point
-number \fIx\fP.
+These functions return the absolute value of the floating-point
+number
+.IR x .
+.SH RETURN VALUE
+These functions return the absolute value of
+.IR x .
+.PP
+If
+.I x
+is a NaN, a NaN is returned.
+.PP
+If
+.I x
+is \-0, +0 is returned.
+.PP
+If
+.I x
+is negative infinity or positive infinity, positive infinity is returned.
 .SH ERRORS
-No errors can occur.
-.SH "CONFORMING TO"
-The
-.BR fabs ()
-function conforms to SVr4, POSIX.1-2001, 4.3BSD, C89.
-The other functions are from C99.
-.SH "SEE ALSO"
+No errors occur.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw24 lb lb
+l l l.
+Interface      Attribute       Value
+T{
+.BR fabs (),
+.BR fabsf (),
+.BR fabsl ()
+T}     Thread safety   MT-Safe
+.TE
+.SH CONFORMING TO
+C99, POSIX.1-2001, POSIX.1-2008.
+.PP
+The variant returning
+.I double
+also conforms to
+SVr4, 4.3BSD, C89.
+.SH SEE ALSO
 .BR abs (3),
-.BR ceil (3),
 .BR cabs (3),
+.BR ceil (3),
 .BR floor (3),
 .BR labs (3),
 .BR rint (3)