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:
Michael Kerrisk 2015-04-12 15:23:50 +02:00
parent 4f337c124b
commit 5600f73afd
50 changed files with 66 additions and 162 deletions

View File

@ -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

View File

@ -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 .

View File

@ -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 .

View File

@ -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 .

View File

@ -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 .

View File

@ -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.

View File

@ -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 .

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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].

View File

@ -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

View File

@ -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.

View File

@ -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

View File

@ -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:

View File

@ -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

View File

@ -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 .

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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:

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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 .

View File

@ -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,

View File

@ -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

View File

@ -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 .

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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.

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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.

View File

@ -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 .

View File

@ -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))

View File

@ -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

View File

@ -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:

View File

@ -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

View File

@ -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

View File

@ -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:

View File

@ -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