OSDN Git Service

LDP: Update original to LDP v3.79
[linuxjm/LDP_man-pages.git] / original / man3 / abs.3
index ab21f9d..b301402 100644 (file)
@@ -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
@@ -29,7 +31,7 @@
 .\" 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  2007-07-26 "GNU" "Linux Programmer's Manual"
+.TH ABS 3  2014-08-19 "GNU" "Linux Programmer's Manual"
 .SH NAME
 abs, labs, llabs, imaxabs \- compute the absolute value of an integer
 .SH SYNOPSIS
@@ -52,9 +54,16 @@ Feature Test Macro Requirements for glibc (see
 .BR feature_test_macros (7)):
 .in
 .sp
+.ad l
 .BR llabs ():
-_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE; or
+.RS 4
+_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE ||
+_POSIX_C_SOURCE\ >=\ 200112L;
+.br
+or
 .I cc\ -std=c99
+.RE
+.ad
 .SH DESCRIPTION
 The
 .BR abs ()
@@ -67,12 +76,21 @@ 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"
+.SH ATTRIBUTES
+.SS Multithreading (see pthreads(7))
+The
+.BR abs (),
+.BR labs (),
+.BR llabs (),
+and
+.BR imaxabs ()
+functions are thread-safe.
+.SH CONFORMING TO
 SVr4, POSIX.1-2001, 4.3BSD, C99.
-.\" POSIX.1 (1996 edition) only requires the
+.\" POSIX.1 (1996 edition) requires only the
 .\" .BR abs ()
 .\" function.
 C89 only
@@ -91,8 +109,7 @@ is not defined.
 .PP
 The
 .BR llabs ()
-function is included in glibc since version 2.0, but
-is not in libc5 or libc4.
+function is included in glibc since version 2.0.
 The
 .BR imaxabs ()
 function is included in
@@ -104,19 +121,27 @@ 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
+By default,
 GCC handles
-.BR abs ()
-and
-.BR labs ()
-as built-in functions.
-GCC 3.0 also handles
+.BR abs (),
+.BR labs (),
+and (since GCC 3.0)
 .BR llabs ()
 and
 .BR imaxabs ()
-as built-ins.
-.SH "SEE ALSO"
+as built-in functions.
+.SH SEE ALSO
 .BR cabs (3),
 .BR ceil (3),
 .BR fabs (3),
 .BR floor (3),
 .BR rint (3)
+.SH COLOPHON
+This page is part of release 3.79 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.