]> git.ipfire.org Git - thirdparty/man-pages.git/blobdiff - man3/gamma.3
fanotify_init.2, fanotify.7: Document FAN_REPORT_TID
[thirdparty/man-pages.git] / man3 / gamma.3
index fa2e91010d8e20d80d23843e6c1a5533ab0c8513..d916e79294a295656098d78abf576964a5cda35a 100644 (file)
@@ -1,35 +1,44 @@
 .\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
+.\"
+.\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
 .\" Distributed under GPL
+.\" %%%LICENSE_END
 .\"
 .\" Modified 2003-11-18, aeb: historical remarks
 .\"
-.TH GAMMA 3 2008-08-05 "GNU" "Linux Programmer's Manual"
+.TH GAMMA 3 2017-09-15 "GNU" "Linux Programmer's Manual"
 .SH NAME
 gamma, gammaf, gammal \- (logarithm of the) gamma function
 .SH SYNOPSIS
 .B #include <math.h>
-.sp
+.PP
 .BI "double gamma(double " x ");"
 .br
 .BI "float gammaf(float " x ");"
 .br
 .BI "long double gammal(long double " x ");"
-.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 gamma ():
-_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE
-.br
+.RS 4
+_XOPEN_SOURCE
+    || /* Since glibc 2.19: */ _DEFAULT_SOURCE
+    || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
+.RE
 .BR gammaf (),
 .BR gammal ():
-_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600
-.\" Also seems to work: -std=c99 -D_XOPEN_SOURCE
+.RS 4
+_XOPEN_SOURCE >= 600 || (_XOPEN_SOURCE && _ISOC99_SOURCE)
+    || /* Since glibc 2.19: */ _DEFAULT_SOURCE
+    || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
+.RE
 .ad b
 .SH DESCRIPTION
 These functions are deprecated: instead, use either the
@@ -37,14 +46,14 @@ These functions are deprecated: instead, use either the
 or the
 .BR lgamma (3)
 functions, as appropriate.
-
+.PP
 For the definition of the Gamma function, see
 .BR tgamma (3).
-.SS "*BSD version"
+.SS *BSD version
 The libm in 4.4BSD and some versions of FreeBSD had a
 .BR gamma ()
 function that computes the Gamma function, as one would expect.
-.SS "glibc version"
+.SS glibc version
 Glibc has a
 .BR gamma ()
 function that is equivalent to
@@ -56,9 +65,24 @@ See
 .SH ERRORS
 See
 .BR lgamma (3).
-.SH "CONFORMING TO"
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw27 lb lb
+l l l.
+Interface      Attribute       Value
+T{
+.BR gamma (),
+.BR gammaf (),
+.BR gammal ()
+T}     Thread safety   MT-Unsafe race:signgam
+.TE
+.SH CONFORMING TO
 Because of historical variations in behavior across systems,
-this function is not specified in any standard.
+this function is not specified in any recent standard.
+It was documented in SVID 2.
 .SH NOTES
 .SS History
 4.2BSD had a
@@ -72,12 +96,12 @@ in the external integer
 In 4.3BSD the name was changed to
 .BR lgamma (3),
 and the man page promises
-.sp
+.PP
 .in +4n
 "At some time in the future the name gamma will be rehabilitated
 and used for the Gamma function"
 .in
-.sp
+.PP
 This did indeed happen in 4.4BSD, where
 .BR gamma ()
 computes the Gamma function (with no effect on
@@ -88,7 +112,7 @@ the "true gamma" function.
 .\" The FreeBSD man page says about gamma() that it is like lgamma()
 .\" except that is does not set signgam.
 .\" Also, that 4.4BSD has a gamma() that computes the true gamma function.
-.SH "SEE ALSO"
+.SH SEE ALSO
 .BR lgamma (3),
 .BR signgam (3),
 .BR tgamma (3)