dlopen.3: Clarify that constructors are called only when library is first loaded

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

diff --git a/man3/carg.3 b/man3/carg.3
index 39d07bd84dc56c700dd2a78a93fea441b92728a3..96e3b6c0c6672dcf86150ed80425fe5f277aabfd 100644 (file)
--- a/man3/carg.3
+++ b/man3/carg.3
@@ -4,38 +4,42 @@
 .\" Distributed under GPL
 .\" %%%LICENSE_END
 .\"
-.TH CARG 3 2015-03-02 "" "Linux Programmer's Manual"
+.TH CARG 3 2017-09-15 "" "Linux Programmer's Manual"
 .SH NAME
 carg, cargf, cargl \- calculate the complex argument
 .SH SYNOPSIS
 .B #include <complex.h>
-.sp
+.PP
 .BI "double carg(double complex " z ");"
 .br
 .BI "float cargf(float complex " z ");"
 .br
 .BI "long double cargl(long double complex " z ");"
-.sp
+.PP
 Link with \fI\-lm\fP.
 .SH DESCRIPTION
+These functions calculate the complex argument (also called phase angle) of
+.IR z ,
+with a branch cut along the negative real axis.
+.PP
 A complex number can be described by two real coordinates.
 One may use rectangular coordinates and gets
-
+.PP
 .nf
     z = x + I * y
 .fi
-
+.PP
 where
 .IR "x\ =\ creal(z)"
 and
 .IR "y\ =\ cimag(z)" .
-.LP
+.PP
 Or one may use polar coordinates and gets
+.PP
 .nf
-
     z = r * cexp(I * a)
-
 .fi
+.PP
 where
 .IR "r\ =\ cabs(z)"
 is the "radius", the "modulus", the absolute value of
@@ -44,10 +48,10 @@ and
 .IR "a\ =\ carg(z)"
 is the "phase angle", the argument of
 .IR z .
-.LP
+.PP
 One has:
+.PP
 .nf
-
     tan(carg(z)) = cimag(z) / creal(z)
 .fi
 .SH RETURN VALUE
@@ -69,7 +73,7 @@ T{
 T}     Thread safety   MT-Safe
 .TE
 .SH CONFORMING TO
-C99, POSIX.1-2001.
+C99, POSIX.1-2001, POSIX.1-2008.
 .SH SEE ALSO
 .BR cabs (3),
 .BR complex (7)