fuse.4: ffix

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

diff --git a/man3/scalbln.3 b/man3/scalbln.3
index d8ffbaaecbd48c620a7860dcb4b8ff973c917555..6c926dae5e2d94b623ef692e44cbaaeea4e585d0 100644 (file)
--- a/man3/scalbln.3
+++ b/man3/scalbln.3
@@ -2,6 +2,7 @@
 .\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk
 .\"     <mtk.manpages@gmail.com>
 .\"
+.\" %%%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.
@@ -21,45 +22,51 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
-.TH SCALBLN 3 2008-08-05 "" "Linux Programmer's Manual"
+.TH SCALBLN 3 2017-09-15 "" "Linux Programmer's Manual"
 .SH NAME
 scalbn, scalbnf, scalbnl, scalbln, scalblnf, scalblnl \-
 multiply floating-point number by integral power of radix
 .SH SYNOPSIS
 .B #include <math.h>
-.sp
+.PP
 .BI "double scalbln(double " x ", long int " exp );
 .br
 .BI "float scalblnf(float " x ", long int " exp );
 .br
 .BI "long double scalblnl(long double " x ", long int " exp );
-.sp
+.PP
 .BI "double scalbn(double " x ", int " exp );
 .br
 .BI "float scalbnf(float " x ", int " exp );
 .br
 .BI "long double scalbnl(long double " x ", int " exp );
-.sp
+.PP
 Link with \fI\-lm\fP.
-.sp
+.PP
 .in -4n
 Feature Test Macro Requirements for glibc (see
 .BR feature_test_macros (7)):
 .in
-.sp
+.PP
 .ad l
 .BR scalbln (),
 .BR scalblnf (),
 .BR scalblnl ():
-_XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE; or
-.I cc\ -std=c99
+.RS
+_ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L
+    || /* Since glibc 2.19: */ _DEFAULT_SOURCE
+.RE
 .br
 .BR scalbn (),
 .BR scalbnf (),
 .BR scalbnl ():
-_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE; or
-.I cc\ -std=c99
+.RS
+_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
 These functions multiply their first argument
@@ -70,32 +77,37 @@ by
 to the power of
 .IR exp ,
 that is:
+.PP
 .nf
-
     x * FLT_RADIX ** exp
 .fi
-
+.PP
 The definition of
 .B FLT_RADIX
 can be obtained by including
 .IR <float.h> .
 .\" not in /usr/include but in a gcc lib
 .SH RETURN VALUE
-On success, these functions return \fIx\fP * \fBFLT_RADIX\fP ** \fIexp\fP.
-
+On success, these functions return
+.IR x
+*
+.B FLT_RADIX
+**
+.IR exp .
+.PP
 If
 .I x
 is a NaN, a NaN is returned.
-
+.PP
 If
 .I x
 is positive infinity (negative infinity),
 positive infinity (negative infinity) is returned.
-
+.PP
 If
 .I x
 is +0 (\-0), +0 (\-0) is returned.
-
+.PP
 If the result overflows,
 a range error occurs,
 and the functions return
@@ -105,7 +117,7 @@ or
 .BR HUGE_VALL ,
 respectively, with a sign the same as
 .IR x .
-
+.PP
 If the result underflows,
 a range error occurs,
 and the functions return zero, with a sign the same as
@@ -138,8 +150,28 @@ These functions do not set
 .IR errno .
 .\" FIXME . Is it intentional that these functions do not set errno?
 .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6803
-.SH "CONFORMING TO"
-C99, POSIX.1-2001.
+.SH VERSIONS
+These functions first appeared in glibc in version 2.1.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw33 lb lb
+l l l.
+Interface      Attribute       Value
+T{
+.BR scalbn (),
+.BR scalbnf (),
+.BR scalbnl (),
+.br
+.BR scalbln (),
+.BR scalblnf (),
+.BR scalblnl ()
+T}     Thread safety   MT-Safe
+.TE
+.SH CONFORMING TO
+C99, POSIX.1-2001, POSIX.1-2008.
 .SH NOTES
 These functions differ from the obsolete functions described in
 .BR scalb (3)
@@ -149,13 +181,13 @@ of an integral type, while those in
 .BR scalb (3)
 have a second argument of type
 .IR double .
-
+.PP
 If
 .B FLT_RADIX
 equals 2 (which is usual), then
 .BR scalbn ()
 is equivalent to
 .BR ldexp (3).
-.SH "SEE ALSO"
+.SH SEE ALSO
 .BR ldexp (3),
 .BR scalb (3)