fanotify_init.2, fanotify.7: Document FAN_REPORT_TID

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

diff --git a/man3/abs.3 b/man3/abs.3
index 4c60f1d384400e64234893bb2afa6e85b1ffba93..af9c5b2d6ab28f4f38d30cae560145d4130e4602 100644 (file)
--- a/man3/abs.3
+++ b/man3/abs.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.
@@ -8,7 +9,7 @@
 .\" manual under the conditions for verbatim copying, provided that the
 .\" entire resulting derived work is distributed under the terms of a
 .\" permission notice identical to this one.
-.\" 
+.\"
 .\" Since the Linux kernel and libraries are constantly changing, this
 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
 .\" responsibility for errors or omissions, or for damages resulting from
@@ -16,9 +17,10 @@
 .\" have taken the same level of care in the production of this manual,
 .\" which is licensed free of charge, as they might when working
 .\" professionally.
-.\" 
+.\"
 .\" 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
@@ -29,51 +31,109 @@
 .\" Modified Sat Jul 24 21:45:37 1993, Rik Faith (faith@cs.unc.edu)
 .\" Modified Sat Dec 16 15:02:59 2000, Joseph S. Myers
 .\"
-.TH ABS 3  2000-12-17 "GNU" "Linux Programmer's Manual"
+.TH ABS 3  2016-03-15 "GNU" "Linux Programmer's Manual"
 .SH NAME
 abs, labs, llabs, imaxabs \- compute the absolute value of an integer
 .SH SYNOPSIS
 .nf
 .B #include <stdlib.h>
-.sp
+.PP
 .BI "int abs(int " j );
-.br
 .BI "long int labs(long int " j );
-.br
 .BI "long long int llabs(long long int " j );
-.sp
+
 .B #include <inttypes.h>
-.sp
+.PP
 .BI "intmax_t imaxabs(intmax_t " j );
 .fi
+.PP
+.in -4n
+Feature Test Macro Requirements for glibc (see
+.BR feature_test_macros (7)):
+.in
+.PP
+.ad l
+.BR llabs ():
+.RS 4
+_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L
+.RE
+.ad
 .SH DESCRIPTION
-The \fBabs()\fP function computes the absolute value of the integer
-argument \fIj\fP.  The \fBlabs()\fP, \fBllabs()\fP and \fBimaxabs()\fP
+The
+.BR abs ()
+function computes the absolute value of the integer
+argument \fIj\fP.
+The
+.BR labs (),
+.BR llabs ()
+and
+.BR imaxabs ()
 functions compute the absolute value of the argument \fIj\fP of the
 appropriate integer type for the function.
-.SH "RETURN VALUE"
+.SH RETURN VALUE
 Returns the absolute value of the integer argument, of the appropriate
 integer type for the function.
-.SH "CONFORMING TO"
-SVID 3, POSIX.1, BSD 4.3, ISO/IEC 9899 (C99).  POSIX.1 (1996 edition) only
-requires the \fBabs()\fP function.  ISO/IEC 9899:1990 (C89) only
-includes the \fBabs()\fP and \fBlabs()\fP functions; the functions
-\fBllabs()\fP and \fBimaxabs()\fP were added in C99.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.ad l
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface      Attribute       Value
+T{
+.BR abs (),
+.BR labs (),
+.BR llabs (),
+.BR imaxabs ()
+T}     Thread safety   MT-Safe
+.TE
+.ad
+.SH CONFORMING TO
+POSIX.1-2001, POSIX.1-2008, C99, SVr4, 4.3BSD.
+.\" POSIX.1 (1996 edition) requires only the
+.\" .BR abs ()
+.\" function.
+C89 only
+includes the
+.BR abs ()
+and
+.BR labs ()
+functions; the functions
+.BR llabs ()
+and
+.BR imaxabs ()
+were added in C99.
 .SH NOTES
 Trying to take the absolute value of the most negative integer
 is not defined.
 .PP
-The \fBllabs()\fP function is included in glibc since version 2.0, but
-is not in libc5 or libc4.  The \fBimaxabs()\fP function is included in
+The
+.BR llabs ()
+function is included in glibc since version 2.0.
+The
+.BR imaxabs ()
+function is included in
 glibc since version 2.1.1.
 .PP
-For \fBllabs()\fP to be declared, it may be necessary to define
+For
+.BR llabs ()
+to be declared, it may be necessary to define
 \fB_ISOC99_SOURCE\fP or \fB_ISOC9X_SOURCE\fP (depending on the
 version of glibc) before including any standard headers.
 .PP
-GCC handles \fBabs()\fP and \fBlabs()\fP as builtin functions.  GCC
-3.0 also handles \fBllabs()\fP and \fBimaxabs()\fP as builtins.
-.SH "SEE ALSO"
+By default,
+GCC handles
+.BR abs (),
+.BR labs (),
+and (since GCC 3.0)
+.BR llabs ()
+and
+.BR imaxabs ()
+as built-in functions.
+.SH SEE ALSO
+.BR cabs (3),
 .BR ceil (3),
 .BR fabs (3),
 .BR floor (3),