mirror of https://github.com/mkerrisk/man-pages
acos.3, acosh.3, asin.3, asinh.3, atan.3, atan2.3, atanh.3, cabs.3, cacos.3, cacosh.3, casin.3, casinh.3, catan.3, catanh.3, cbrt.3, cexp.3, cimag.3, conj.3, copysign.3, cos.3, cosh.3, cpow.3, creal.3, erf.3, erfc.3, exp.3, exp10.2, exp2.3, expm1.3, fma.3, fmod.3, frexp.3, hypot.3, ldexp.3, lgamma.3, log.3, log10.3, log1p.3, log2.3, modf.3, pow.3, pow10.3, remainder.3, significand.3, sin.3, sinh.3, sqrt.3, tan.3, tanh.3, tgamma.3: wfix: use consistent wording to describe functions
exp10.3, lgamma.3, modf.3, pow10.3, remainder.3, significand.3:dd Where a page describes multiple math functions with float, double, and long double variants, just describe them as "These functions" rather than describing in terms of just the double variant. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
parent
4f337c124b
commit
5600f73afd
|
@ -63,9 +63,7 @@ or
|
|||
.RE
|
||||
.ad b
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR acos ()
|
||||
function calculates the arc cosine of
|
||||
These functions calculate the arc cosine of
|
||||
.IR x ;
|
||||
that is
|
||||
the value whose cosine is
|
||||
|
|
|
@ -75,9 +75,7 @@ or
|
|||
.RE
|
||||
.ad b
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR acosh ()
|
||||
function calculates the inverse hyperbolic cosine of
|
||||
These functions calculate the inverse hyperbolic cosine of
|
||||
.IR x ;
|
||||
that is the value whose hyperbolic cosine is
|
||||
.IR x .
|
||||
|
|
|
@ -65,9 +65,7 @@ or
|
|||
.RE
|
||||
.ad b
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR asin ()
|
||||
function calculates the principal value of the arc sine of
|
||||
These functions calculate the principal value of the arc sine of
|
||||
.IR x ;
|
||||
that is the value whose sine is
|
||||
.IR x .
|
||||
|
|
|
@ -75,9 +75,7 @@ or
|
|||
.RE
|
||||
.ad b
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR asinh ()
|
||||
function calculates the inverse hyperbolic sine of
|
||||
These functions calculate the inverse hyperbolic sine of
|
||||
.IR x ;
|
||||
that is the value whose hyperbolic sine is
|
||||
.IR x .
|
||||
|
|
|
@ -65,9 +65,7 @@ or
|
|||
.RE
|
||||
.ad b
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR atan ()
|
||||
function calculates the principal value of the arc tangent of
|
||||
These functions calculate the principal value of the arc tangent of
|
||||
.IR x ;
|
||||
that is the value whose tangent is
|
||||
.IR x .
|
||||
|
|
|
@ -63,9 +63,7 @@ or
|
|||
.RE
|
||||
.ad b
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR atan2 ()
|
||||
function calculates the principal value of the arc tangent of
|
||||
These functions calculate the principal value of the arc tangent of
|
||||
.IR y/x ,
|
||||
using the signs of the two arguments to determine
|
||||
the quadrant of the result.
|
||||
|
|
|
@ -75,9 +75,7 @@ or
|
|||
.RE
|
||||
.ad b
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR atanh ()
|
||||
function calculates the inverse hyperbolic tangent of
|
||||
These functions calculate the inverse hyperbolic tangent of
|
||||
.IR x ;
|
||||
that is the value whose hyperbolic tangent is
|
||||
.IR x .
|
||||
|
|
|
@ -18,9 +18,7 @@ cabs, cabsf, cabsl \- absolute value of a complex number
|
|||
.sp
|
||||
Link with \fI\-lm\fP.
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR cabs ()
|
||||
function returns the absolute value of the complex number
|
||||
These functions return the absolute value of the complex number
|
||||
.IR z .
|
||||
The result is a real number.
|
||||
.SH VERSIONS
|
||||
|
|
|
@ -19,9 +19,7 @@ cacos, cacosf, cacosl \- complex arc cosine
|
|||
.sp
|
||||
Link with \fI\-lm\fP.
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR cacos ()
|
||||
function calculates the complex arc cosine of
|
||||
These functions calculate the complex arc cosine of
|
||||
.IR z .
|
||||
If \fIy\ =\ cacos(z)\fP, then \fIz\ =\ ccos(y)\fP.
|
||||
The real part of
|
||||
|
|
|
@ -19,9 +19,7 @@ cacosh, cacoshf, cacoshl \- complex arc hyperbolic cosine
|
|||
.sp
|
||||
Link with \fI\-lm\fP.
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR cacosh ()
|
||||
function calculates the complex arc hyperbolic cosine of
|
||||
These functions calculate the complex arc hyperbolic cosine of
|
||||
.IR z .
|
||||
If \fIy\ =\ cacosh(z)\fP, then \fIz\ =\ ccosh(y)\fP.
|
||||
The imaginary part of
|
||||
|
|
|
@ -18,9 +18,7 @@ casin, casinf, casinl \- complex arc sine
|
|||
.sp
|
||||
Link with \fI\-lm\fP.
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR casin ()
|
||||
function calculates the complex arc sine of
|
||||
These functions calculate the complex arc sine of
|
||||
.IR z .
|
||||
If \fIy\ =\ casin(z)\fP, then \fIz\ =\ csin(y)\fP.
|
||||
The real part of
|
||||
|
|
|
@ -18,9 +18,7 @@ casinh, casinhf, casinhl \- complex arc sine hyperbolic
|
|||
.sp
|
||||
Link with \fI\-lm\fP.
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR casinh ()
|
||||
function calculates the complex arc hyperbolic sine of
|
||||
These functions calculate the complex arc hyperbolic sine of
|
||||
.IR z .
|
||||
If \fIy\ =\ casinh(z)\fP, then \fIz\ =\ csinh(y)\fP.
|
||||
The imaginary part of
|
||||
|
|
|
@ -19,9 +19,7 @@ catan, catanf, catanl \- complex arc tangents
|
|||
.sp
|
||||
Link with \fI\-lm\fP.
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR catan ()
|
||||
function calculates the complex arc tangent of
|
||||
These functions calculate the complex arc tangent of
|
||||
.IR z .
|
||||
If \fIy\ =\ catan(z)\fP, then \fIz\ =\ ctan(y)\fP.
|
||||
The real part of y is chosen in the interval [\-pi/2,pi/2].
|
||||
|
|
|
@ -19,9 +19,7 @@ catanh, catanhf, catanhl \- complex arc tangents hyperbolic
|
|||
.sp
|
||||
Link with \fI\-lm\fP.
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR catanh ()
|
||||
function calculates the complex arc hyperbolic tangent of
|
||||
These functions calculate the complex arc hyperbolic tangent of
|
||||
.IR z .
|
||||
If \fIy\ =\ catanh(z)\fP, then \fIz\ =\ ctanh(y)\fP.
|
||||
The imaginary part of
|
||||
|
|
|
@ -70,9 +70,7 @@ or
|
|||
.RE
|
||||
.ad b
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR cbrt ()
|
||||
function returns the (real) cube root of
|
||||
These functions return the (real) cube root of
|
||||
.IR x .
|
||||
This function cannot fail; every representable real value has a
|
||||
representable real cube root.
|
||||
|
|
|
@ -18,7 +18,7 @@ cexp, cexpf, cexpl \- complex exponential function
|
|||
.sp
|
||||
Link with \fI\-lm\fP.
|
||||
.SH DESCRIPTION
|
||||
The function calculates e (2.71828..., the base of natural logarithms)
|
||||
These functions calculate e (2.71828..., the base of natural logarithms)
|
||||
raised to the power of
|
||||
.IR z .
|
||||
.LP
|
||||
|
|
|
@ -18,9 +18,7 @@ cimag, cimagf, cimagl \- get imaginary part of a complex number
|
|||
.sp
|
||||
Link with \fI\-lm\fP.
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR cimag ()
|
||||
function returns the imaginary part of the complex number
|
||||
These functions return the imaginary part of the complex number
|
||||
.IR z .
|
||||
.LP
|
||||
One has:
|
||||
|
|
|
@ -18,9 +18,7 @@ conj, conjf, conjl \- calculate the complex conjugate
|
|||
.sp
|
||||
Link with \fI\-lm\fP.
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR conj ()
|
||||
function returns the complex conjugate value of
|
||||
These functions return the complex conjugate value of
|
||||
.IR z .
|
||||
That is the value obtained by changing the sign of the imaginary part.
|
||||
.LP
|
||||
|
|
|
@ -62,13 +62,7 @@ or
|
|||
.RE
|
||||
.ad b
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR copysign (),
|
||||
.BR copysignf (),
|
||||
and
|
||||
.BR copysignl ()
|
||||
functions return a value whose absolute value matches
|
||||
that of
|
||||
These functions return a value whose absolute value matches that of
|
||||
.IR x ,
|
||||
but whose sign bit matches that of
|
||||
.IR y .
|
||||
|
|
|
@ -64,9 +64,7 @@ or
|
|||
.RE
|
||||
.ad
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR cos ()
|
||||
function returns the cosine of
|
||||
These functions return the cosine of
|
||||
.IR x ,
|
||||
where
|
||||
.I x
|
||||
|
|
|
@ -66,12 +66,9 @@ or
|
|||
.RE
|
||||
.ad
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR cosh ()
|
||||
function returns the hyperbolic cosine of
|
||||
These functions return the hyperbolic cosine of
|
||||
.IR x ,
|
||||
which
|
||||
is defined mathematically as:
|
||||
which is defined mathematically as:
|
||||
.nf
|
||||
|
||||
cosh(x) = (exp(x) + exp(\-x)) / 2
|
||||
|
|
|
@ -21,11 +21,11 @@ cpow, cpowf, cpowl \- complex power function
|
|||
Link with \fI\-lm\fP.
|
||||
.fi
|
||||
.SH DESCRIPTION
|
||||
The function calculates
|
||||
These functions calculate
|
||||
.I x
|
||||
raised to the power
|
||||
.IR z .
|
||||
(With a branch cut for
|
||||
.IR z
|
||||
(with a branch cut for
|
||||
.I x
|
||||
along the negative real axis.)
|
||||
.SH VERSIONS
|
||||
|
|
|
@ -18,9 +18,7 @@ creal, crealf, creall \- get real part of a complex number
|
|||
.sp
|
||||
Link with \fI\-lm\fP.
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR creal ()
|
||||
function returns the real part of the complex number
|
||||
These functions return the real part of the complex number
|
||||
.IR z .
|
||||
.LP
|
||||
One has:
|
||||
|
|
|
@ -72,12 +72,9 @@ or
|
|||
.RE
|
||||
.ad b
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR erf ()
|
||||
function returns the error function of
|
||||
These functions return the error function of
|
||||
.IR x ,
|
||||
defined
|
||||
as
|
||||
defined as
|
||||
.TP
|
||||
erf(x) = 2/sqrt(pi)* integral from 0 to x of exp(\-t*t) dt
|
||||
.SH RETURN VALUE
|
||||
|
|
|
@ -63,9 +63,7 @@ or
|
|||
.RE
|
||||
.ad b
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR erfc ()
|
||||
function returns the complementary error function of
|
||||
These functions return the complementary error function of
|
||||
.IR x ,
|
||||
that is, 1.0 \- erf(x).
|
||||
.SH RETURN VALUE
|
||||
|
|
|
@ -66,9 +66,7 @@ or
|
|||
.RE
|
||||
.ad b
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR exp ()
|
||||
function returns the value of e (the base of natural
|
||||
These functions return the value of e (the base of natural
|
||||
logarithms) raised to the power of
|
||||
.IR x .
|
||||
.SH RETURN VALUE
|
||||
|
|
|
@ -50,9 +50,7 @@ exp10, exp10f, exp10l \- base-10 exponential function
|
|||
.sp
|
||||
Link with \fI\-lm\fP.
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR exp10 ()
|
||||
function returns the value of 10
|
||||
These functions return the value of 10
|
||||
raised to the power of
|
||||
.IR x .
|
||||
.SH RETURN VALUE
|
||||
|
|
|
@ -66,10 +66,7 @@ or
|
|||
.RE
|
||||
.ad b
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR exp2 ()
|
||||
function returns the value of 2
|
||||
raised to the power of
|
||||
These functions return the value of 2 raised to the power of
|
||||
.IR x .
|
||||
.SH RETURN VALUE
|
||||
On success, these functions return the base-2 exponential value of
|
||||
|
|
|
@ -70,15 +70,13 @@ or
|
|||
.RE
|
||||
.ad b
|
||||
.SH DESCRIPTION
|
||||
.I expm1(x)
|
||||
returns a value equivalent to
|
||||
These functions return a value equivalent to
|
||||
.nf
|
||||
|
||||
exp(x) \- 1
|
||||
|
||||
.fi
|
||||
It is
|
||||
computed in a way that is accurate even if the value of
|
||||
The result is computed in a way that is accurate even if the value of
|
||||
.I x
|
||||
is near
|
||||
zero\(ema case where
|
||||
|
|
|
@ -43,9 +43,7 @@ or
|
|||
.RE
|
||||
.ad
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR fma ()
|
||||
function computes
|
||||
These functions compute
|
||||
.IR x " * " y " + " z .
|
||||
The result is rounded as one ternary operation according to the
|
||||
current rounding mode (see
|
||||
|
|
|
@ -65,9 +65,7 @@ or
|
|||
.RE
|
||||
.ad
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR fmod ()
|
||||
function computes the floating-point remainder of dividing
|
||||
These functions compute the floating-point remainder of dividing
|
||||
.I x
|
||||
by
|
||||
.IR y .
|
||||
|
|
|
@ -64,17 +64,13 @@ or
|
|||
.RE
|
||||
.ad
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR frexp ()
|
||||
function is used to split the number
|
||||
These functions are used to split the number
|
||||
.I x
|
||||
into a
|
||||
normalized fraction and an exponent which is stored in
|
||||
.IR exp .
|
||||
.SH RETURN VALUE
|
||||
The
|
||||
.BR frexp ()
|
||||
function returns the normalized fraction.
|
||||
These functions return the normalized fraction.
|
||||
If the argument
|
||||
.I x
|
||||
is not zero,
|
||||
|
|
|
@ -72,9 +72,7 @@ or
|
|||
.RE
|
||||
.ad b
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR hypot ()
|
||||
function returns
|
||||
These functions return
|
||||
.RI sqrt( x * x + y * y ).
|
||||
This is the length of the hypotenuse of a right-angled triangle
|
||||
with sides of length
|
||||
|
|
|
@ -64,9 +64,7 @@ or
|
|||
.RE
|
||||
.ad
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR ldexp ()
|
||||
function returns the result of multiplying the floating-point number
|
||||
These functions return the result of multiplying the floating-point number
|
||||
.I x
|
||||
by 2 raised to the power
|
||||
.IR exp .
|
||||
|
|
|
@ -73,8 +73,11 @@ For the definition of the Gamma function, see
|
|||
.BR tgamma (3).
|
||||
.PP
|
||||
The
|
||||
.BR lgamma ()
|
||||
function returns the natural logarithm of
|
||||
.BR lgamma (),
|
||||
.BR lgammaf (),
|
||||
and
|
||||
.BR lgammal ()
|
||||
functions return the natural logarithm of
|
||||
the absolute value of the Gamma function.
|
||||
The sign of the Gamma function is returned in the
|
||||
external integer
|
||||
|
|
|
@ -66,9 +66,7 @@ or
|
|||
.RE
|
||||
.ad
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR log ()
|
||||
function returns the natural logarithm of
|
||||
These functions return the natural logarithm of
|
||||
.IR x .
|
||||
.SH RETURN VALUE
|
||||
On success, these functions return the natural logarithm of
|
||||
|
|
|
@ -66,9 +66,7 @@ or
|
|||
.RE
|
||||
.ad
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR log10 ()
|
||||
function returns the base 10 logarithm of
|
||||
These functions return the base 10 logarithm of
|
||||
.IR x .
|
||||
.SH RETURN VALUE
|
||||
On success, these functions return the base 10 logarithm of
|
||||
|
|
|
@ -69,14 +69,13 @@ or
|
|||
.RE
|
||||
.ad b
|
||||
.SH DESCRIPTION
|
||||
.I log1p(x)
|
||||
returns a value equivalent to
|
||||
These functions return a value equivalent to
|
||||
.nf
|
||||
|
||||
log (1 + \fIx\fP)
|
||||
|
||||
.fi
|
||||
It is computed in a way
|
||||
The result is computed in a way
|
||||
that is accurate even if the value of
|
||||
.I x
|
||||
is near zero.
|
||||
|
|
|
@ -66,9 +66,7 @@ or
|
|||
.RE
|
||||
.ad b
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR log2 ()
|
||||
function returns the base 2 logarithm of
|
||||
These functions return the base 2 logarithm of
|
||||
.IR x .
|
||||
.SH RETURN VALUE
|
||||
On success, these functions return the base 2 logarithm of
|
||||
|
|
|
@ -64,9 +64,7 @@ or
|
|||
.RE
|
||||
.ad
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR modf ()
|
||||
function breaks the argument
|
||||
These functions break the argument
|
||||
.I x
|
||||
into an integral
|
||||
part and a fractional part, each of which has the same sign as
|
||||
|
@ -74,9 +72,7 @@ part and a fractional part, each of which has the same sign as
|
|||
The integral part is stored in the location pointed to by
|
||||
.IR iptr .
|
||||
.SH RETURN VALUE
|
||||
The
|
||||
.BR modf ()
|
||||
function returns the fractional part of
|
||||
These functions return the fractional part of
|
||||
.IR x .
|
||||
|
||||
If
|
||||
|
|
|
@ -65,9 +65,7 @@ or
|
|||
.RE
|
||||
.ad
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR pow ()
|
||||
function returns the value of
|
||||
These functions return the value of
|
||||
.I x
|
||||
raised to the
|
||||
power of
|
||||
|
|
|
@ -39,10 +39,7 @@ pow10, pow10f, pow10l \- base-10 power functions
|
|||
.sp
|
||||
Link with \fI\-lm\fP.
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR pow10 ()
|
||||
function returns the value of 10 raised to the
|
||||
power
|
||||
These functions return the value of 10 raised to the power
|
||||
.IR x .
|
||||
.SH VERSIONS
|
||||
These functions first appeared in glibc in version 2.1.
|
||||
|
|
|
@ -90,9 +90,8 @@ _SVID_SOURCE || _BSD_SOURCE
|
|||
.RE
|
||||
.ad b
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR remainder ()
|
||||
function computes the remainder of dividing
|
||||
These
|
||||
functions compute the remainder of dividing
|
||||
.I x
|
||||
by
|
||||
.IR y .
|
||||
|
|
|
@ -35,12 +35,10 @@ _SVID_SOURCE || _BSD_SOURCE
|
|||
.RE
|
||||
.ad b
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR significand ()
|
||||
function returns the mantissa of
|
||||
These functions return the mantissa of
|
||||
.I x
|
||||
scaled to the range [1,2).
|
||||
It is equivalent to
|
||||
They are equivalent to
|
||||
.sp
|
||||
.in +4n
|
||||
scalb(x, (double) \-ilogb(x))
|
||||
|
|
|
@ -65,9 +65,7 @@ or
|
|||
.RE
|
||||
.ad
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR sin ()
|
||||
function returns the sine of
|
||||
These functions return the sine of
|
||||
.IR x ,
|
||||
where
|
||||
.I x
|
||||
|
|
|
@ -66,9 +66,7 @@ or
|
|||
.RE
|
||||
.ad
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR sinh ()
|
||||
function returns the hyperbolic sine of
|
||||
These functions return the hyperbolic sine of
|
||||
.IR x ,
|
||||
which
|
||||
is defined mathematically as:
|
||||
|
|
|
@ -64,9 +64,7 @@ or
|
|||
.RE
|
||||
.ad
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR sqrt ()
|
||||
function returns the nonnegative square root of
|
||||
These functions return the nonnegative square root of
|
||||
.IR x .
|
||||
.SH RETURN VALUE
|
||||
On success, these functions return the square root of
|
||||
|
|
|
@ -65,9 +65,7 @@ or
|
|||
.RE
|
||||
.ad
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR tan ()
|
||||
function returns the tangent of
|
||||
These functions return the tangent of
|
||||
.IR x ,
|
||||
where
|
||||
.I x
|
||||
|
|
|
@ -65,9 +65,7 @@ or
|
|||
.RE
|
||||
.ad
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.BR tanh ()
|
||||
function returns the hyperbolic tangent of
|
||||
These functions return the hyperbolic tangent of
|
||||
.IR x ,
|
||||
which
|
||||
is defined mathematically as:
|
||||
|
|
|
@ -42,6 +42,9 @@ or
|
|||
.RE
|
||||
.ad
|
||||
.SH DESCRIPTION
|
||||
These functions calculate the Gamma function of
|
||||
.IR x .
|
||||
|
||||
The Gamma function is defined by
|
||||
.sp
|
||||
Gamma(x) = integral from 0 to infinity of t^(x\-1) e^\-t dt
|
||||
|
|
Loading…
Reference in New Issue