diff --git a/lib/msun/man/acos.3 b/lib/msun/man/acos.3 index e0c7e676f5d6..4e75f854c1da 100644 --- a/lib/msun/man/acos.3 +++ b/lib/msun/man/acos.3 @@ -1,87 +1,87 @@ .\" Copyright (c) 1991 The Regents of the University of California. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" from: @(#)acos.3 5.1 (Berkeley) 5/2/91 .\" $FreeBSD$ .\" .Dd July 31, 2008 .Dt ACOS 3 .Os .Sh NAME .Nm acos , .Nm acosf , .Nm acosl .Nd arc cosine functions .Sh LIBRARY .Lb libm .Sh SYNOPSIS .In math.h .Ft double .Fn acos "double x" .Ft float .Fn acosf "float x" .Ft long double .Fn acosl "long double x" .Sh DESCRIPTION The .Fn acos , .Fn acosf , and .Fn acosl functions compute the principal value of the arc cosine of .Fa x . .Sh RETURN VALUES These functions return the arc cosine in the range .Bq 0 , \*(Pi radians. If: .Bd -unfilled -offset indent -.Pf \&| Ns Ar x Ns \&| > 1 , +.Pf \&| Ns Fa x Ns \&| > 1 , .Ed .Pp .Fn acos x raises an invalid exception and returns an \*(Na. .Sh SEE ALSO .Xr asin 3 , .Xr atan 3 , .Xr atan2 3 , .Xr cos 3 , .Xr cosh 3 , .Xr fenv 3 , .Xr math 3 , .Xr sin 3 , .Xr sinh 3 , .Xr tan 3 , .Xr tanh 3 .Sh STANDARDS The .Fn acos , .Fn acosf , and .Fn acosl functions conform to .St -isoC-99 . diff --git a/lib/msun/man/acosh.3 b/lib/msun/man/acosh.3 index 6af85f85ddfb..c2943317573c 100644 --- a/lib/msun/man/acosh.3 +++ b/lib/msun/man/acosh.3 @@ -1,85 +1,85 @@ .\" Copyright (c) 1991 Regents of the University of California. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" from: @(#)acosh.3 5.2 (Berkeley) 5/6/91 .\" $FreeBSD$ .\" .Dd June 9, 2013 .Dt ACOSH 3 .Os .Sh NAME .Nm acosh , .Nm acoshf , .Nm acoshl .Nd inverse hyperbolic cosine functions .Sh LIBRARY .Lb libm .Sh SYNOPSIS .In math.h .Ft double .Fn acosh "double x" .Ft float .Fn acoshf "float x" .Ft long double .Fn acoshl "long double x" .Sh DESCRIPTION The .Fn acosh , .Fn acoshf , and .Fn acoshl functions compute the inverse hyperbolic cosine of the real argument -.Ar x . +.Fa x . For a discussion of error due to roundoff, see .Xr math 3 . .Sh RETURN VALUES These functions return the inverse hyperbolic cosine of -.Ar x . +.Fa x . If the argument is less than 1, .Fn acosh raises an invalid exception and returns an \*(Na. .Sh SEE ALSO .Xr asinh 3 , .Xr atanh 3 , .Xr exp 3 , .Xr fenv 3 , .Xr math 3 .Sh HISTORY The .Fn acosh , .Fn acoshf , and .Fn acoshl functions appeared in .Bx 4.3 , .Fx 2.0 , and .Fx 10.0 , respectively. diff --git a/lib/msun/man/asin.3 b/lib/msun/man/asin.3 index 8bb3c3be66ec..15c181bd8d1f 100644 --- a/lib/msun/man/asin.3 +++ b/lib/msun/man/asin.3 @@ -1,89 +1,89 @@ .\" Copyright (c) 1991 The Regents of the University of California. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" from: @(#)asin.3 5.1 (Berkeley) 5/2/91 .\" $FreeBSD$ .\" .Dd July 31, 2008 .Dt ASIN 3 .Os .Sh NAME .Nm asin , .Nm asinf , .Nm asinl .Nd arc sine functions .Sh LIBRARY .Lb libm .Sh SYNOPSIS .In math.h .Ft double .Fn asin "double x" .Ft float .Fn asinf "float x" .Ft long double .Fn asinl "long double x" .Sh DESCRIPTION The .Fn asin , .Fn asinf , and .Fn asinl functions compute the principal value of the arc sine of .Fa x . .Sh RETURN VALUES These functions return the arc sine in the range .Bk -words .Bq -\*(Pi/2 , +\*(Pi/2 .Ek radians. If: .Bd -unfilled -offset indent -.Pf \&| Ns Ar x Ns \&| > 1 +.Pf \&| Ns Fa x Ns \&| > 1 .Ed .Pp .Fn asin x raises an invalid exception and returns an \*(Na. .Sh SEE ALSO .Xr acos 3 , .Xr atan 3 , .Xr atan2 3 , .Xr cos 3 , .Xr cosh 3 , .Xr fenv 3 , .Xr math 3 , .Xr sin 3 , .Xr sinh 3 , .Xr tan 3 , .Xr tanh 3 .Sh STANDARDS The .Fn asin , .Fn asinf , and .Fn asinl functions conform to .St -isoC-99 . diff --git a/lib/msun/man/asinh.3 b/lib/msun/man/asinh.3 index 38b33175dd2a..c2181dc49d32 100644 --- a/lib/msun/man/asinh.3 +++ b/lib/msun/man/asinh.3 @@ -1,81 +1,81 @@ .\" Copyright (c) 1985, 1991 Regents of the University of California. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" from: @(#)asinh.3 6.4 (Berkeley) 5/6/91 .\" $FreeBSD$ .\" .Dd June 9, 2013 .Dt ASINH 3 .Os .Sh NAME .Nm asinh , .Nm asinhf , .Nm asinhl .Nd inverse hyperbolic sine functions .Sh LIBRARY .Lb libm .Sh SYNOPSIS .In math.h .Ft double .Fn asinh "double x" .Ft float .Fn asinhf "float x" .Ft long double .Fn asinhl "long double x" .Sh DESCRIPTION The .Fn asinh , .Fn asinhf , and .Fn asinhl functions compute the inverse hyperbolic sine of the real argument -.Ar x . +.Fa x . For a discussion of error due to roundoff, see .Xr math 3 . .Sh RETURN VALUES These functions return the inverse hyperbolic sine of -.Ar x . +.Fa x . .Sh SEE ALSO .Xr acosh 3 , .Xr atanh 3 , .Xr exp 3 , .Xr math 3 .Sh HISTORY The .Fn asinh , .Fn asinhf , and .Fn asinhl functions appeared in .Bx 4.3 , .Fx 2.0 , and .Fx 10.0 , respectively. diff --git a/lib/msun/man/atan2.3 b/lib/msun/man/atan2.3 index 59c8a0e3de36..307dadd1a628 100644 --- a/lib/msun/man/atan2.3 +++ b/lib/msun/man/atan2.3 @@ -1,225 +1,225 @@ .\" Copyright (c) 1991 The Regents of the University of California. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" from: @(#)atan2.3 5.1 (Berkeley) 5/2/91 .\" $FreeBSD$ .\" .Dd July 31, 2008 .Dt ATAN2 3 .Os .Sh NAME .Nm atan2 , .Nm atan2f , .Nm atan2l , .Nm carg , .Nm cargf , .Nm cargl .Nd arc tangent and complex phase angle functions .Sh LIBRARY .Lb libm .Sh SYNOPSIS .In math.h .Ft double .Fn atan2 "double y" "double x" .Ft float .Fn atan2f "float y" "float x" .Ft long double .Fn atan2l "long double y" "long double x" .In complex.h .Ft double .Fn carg "double complex z" .Ft float .Fn cargf "float complex z" .Ft long double .Fn cargl "long double complex z" .Sh DESCRIPTION The .Fn atan2 , .Fn atan2f , and .Fn atan2l functions compute the principal value of the arc tangent of -.Fa y/ Ns Ar x , +.Fa y/ Ns Fa x , using the signs of both arguments to determine the quadrant of the return value. .Pp The .Fn carg , .Fn cargf , and .Fn cargl functions compute the complex argument (or phase angle) of .Fa z . The complex argument is the number theta such that .Li z = r * e^(I * theta) , where .Li r = cabs(z) . The call .Li carg(z) is equivalent to .Li atan2(cimag(z), creal(z)) , and similarly for .Fn cargf and .Fn cargl . .Sh RETURN VALUES The .Fn atan2 , .Fn atan2f , and .Fn atan2l functions, if successful, return the arc tangent of -.Fa y/ Ns Ar x +.Fa y/ Ns Fa x in the range .Bk -words .Bq \&- Ns \*(Pi , \&+ Ns \*(Pi .Ek radians. Here are some of the special cases: .Bl -column atan_(y,x)_:=____ sign(y)_(Pi_atan2(Xy_xX))___ .It Fn atan2 y x No := Ta .Fn atan y/x Ta if -.Ar x +.Fa x > 0, -.It Ta sign( Ns Ar y Ns )*(\*(Pi - +.It Ta sign( Ns Fa y Ns )*(\*(Pi - .Fn atan "\*(Bay/x\*(Ba" ) Ta if -.Ar x +.Fa x < 0, .It Ta .No 0 Ta if x = y = 0, or .It Ta -.Pf sign( Ar y Ns )*\*(Pi/2 Ta +.Pf sign( Fa y Ns )*\*(Pi/2 Ta if -.Ar x +.Fa x = 0 \(!= -.Ar y . +.Fa y . .El .Sh NOTES The function .Fn atan2 defines "if x > 0," .Fn atan2 0 0 = 0 despite that previously .Fn atan2 0 0 may have generated an error message. The reasons for assigning a value to .Fn atan2 0 0 are these: .Bl -enum -offset indent .It Programs that test arguments to avoid computing .Fn atan2 0 0 must be indifferent to its value. Programs that require it to be invalid are vulnerable to diverse reactions to that invalidity on diverse computer systems. .It The .Fn atan2 function is used mostly to convert from rectangular (x,y) to polar .if n\ (r,theta) .if t\ (r,\(*h) coordinates that must satisfy x = .if n\ r\(**cos theta .if t\ r\(**cos\(*h and y = .if n\ r\(**sin theta. .if t\ r\(**sin\(*h. These equations are satisfied when (x=0,y=0) is mapped to .if n \ (r=0,theta=0). .if t \ (r=0,\(*h=0). In general, conversions to polar coordinates should be computed thus: .Bd -unfilled -offset indent .if n \{\ r := hypot(x,y); ... := sqrt(x\(**x+y\(**y) theta := atan2(y,x). .\} .if t \{\ r := hypot(x,y); ... := \(sr(x\u\s82\s10\d+y\u\s82\s10\d) \(*h := atan2(y,x). .\} .Ed .It The foregoing formulas need not be altered to cope in a reasonable way with signed zeros and infinities on a machine that conforms to .Tn IEEE 754 ; the versions of .Xr hypot 3 and .Fn atan2 provided for such a machine are designed to handle all cases. That is why .Fn atan2 \(+-0 \-0 = \(+-\*(Pi for instance. In general the formulas above are equivalent to these: .Bd -unfilled -offset indent .if n \ r := sqrt(x\(**x+y\(**y); if r = 0 then x := copysign(1,x); .if t \ r := \(sr(x\(**x+y\(**y);\0\0if r = 0 then x := copysign(1,x); .Ed .El .Sh SEE ALSO .Xr acos 3 , .Xr asin 3 , .Xr atan 3 , .Xr cabs 3 , .Xr cos 3 , .Xr cosh 3 , .Xr math 3 , .Xr sin 3 , .Xr sinh 3 , .Xr tan 3 , .Xr tanh 3 .Sh STANDARDS The .Fn atan2 , .Fn atan2f , .Fn atan2l , .Fn carg , .Fn cargf , and .Fn cargl functions conform to .St -isoC-99 . diff --git a/lib/msun/man/atanh.3 b/lib/msun/man/atanh.3 index 5c3bb7e30f16..5984ee89337e 100644 --- a/lib/msun/man/atanh.3 +++ b/lib/msun/man/atanh.3 @@ -1,88 +1,88 @@ .\" Copyright (c) 1985, 1991 Regents of the University of California. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" from: @(#)atanh.3 5.2 (Berkeley) 5/6/91 .\" $FreeBSD$ .\" .Dd June 9, 2013 .Dt ATANH 3 .Os .Sh NAME .Nm atanh , .Nm atanhf , .Nm atanhl .Nd inverse hyperbolic tangent functions .Sh LIBRARY .Lb libm .Sh SYNOPSIS .In math.h .Ft double .Fn atanh "double x" .Ft float .Fn atanhf "float x" .Ft long double .Fn atanhl "long double x" .Sh DESCRIPTION The .Fn atanh , .Fn atanhf , and .Fn atanhl functions compute the inverse hyperbolic tangent of the real argument -.Ar x . +.Fa x . For a discussion of error due to roundoff, see .Xr math 3 . .Sh RETURN VALUES These functions return the inverse hyperbolic tangent of -.Ar x +.Fa x if successful. If the argument has absolute value 1, a divide-by-zero exception is raised and an infinity is returned. If -.Ar |x| +.Fa |x| > 1, an invalid exception is raised and an \*(Na is returned. .Sh SEE ALSO .Xr acosh 3 , .Xr asinh 3 , .Xr exp 3 , .Xr fenv 3 , .Xr math 3 .Sh HISTORY The .Fn atanh , .Fn atanhf , and .Fn atanhl functions appeared in .Bx 4.3 , .Fx 2.0 , and .Fx 10.0 , respectively. diff --git a/lib/msun/man/ccos.3 b/lib/msun/man/ccos.3 index c07205e6d91d..2c66b6b1b9cf 100644 --- a/lib/msun/man/ccos.3 +++ b/lib/msun/man/ccos.3 @@ -1,81 +1,81 @@ .\" Copyright (c) 2011 David Schultz .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" $FreeBSD$ .\" .Dd October 17, 2011 .Dt CCOS 3 .Os .Sh NAME .Nm ccos , .Nm ccosf , .Nm csin , -.Nm csinf +.Nm csinf , .Nm ctan , .Nm ctanf .Nd complex trigonometric functions .Sh LIBRARY .Lb libm .Sh SYNOPSIS .In complex.h .Ft double complex .Fn ccos "double complex z" .Ft float complex .Fn ccosf "float complex z" .Ft double complex .Fn csin "double complex z" .Ft float complex .Fn csinf "float complex z" .Ft double complex .Fn ctan "double complex z" .Ft float complex .Fn ctanf "float complex z" .Sh DESCRIPTION The .Fn ccos , .Fn csin , and .Fn ctan functions compute the cosine, sine, and tangent of the complex number .Fa z , respectively. The .Fn ccosf , .Fn csinf , and .Fn ctanf functions perform the same operations in .Fa float precision. .Sh SEE ALSO .Xr cacos 3 , .Xr ccosh 3 , .Xr complex 3 , .Xr cos 3 , .Xr math 3 , .Xr sin 3 , .Xr tan 3 .Sh STANDARDS These functions conform to .St -isoC-99 . diff --git a/lib/msun/man/ccosh.3 b/lib/msun/man/ccosh.3 index f006442cdc1d..748b5429b072 100644 --- a/lib/msun/man/ccosh.3 +++ b/lib/msun/man/ccosh.3 @@ -1,81 +1,81 @@ .\" Copyright (c) 2011 David Schultz .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" $FreeBSD$ .\" .Dd October 17, 2011 .Dt CCOSH 3 .Os .Sh NAME .Nm ccosh , .Nm ccoshf , .Nm csinh , -.Nm csinhf +.Nm csinhf , .Nm ctanh , .Nm ctanhf .Nd complex hyperbolic functions .Sh LIBRARY .Lb libm .Sh SYNOPSIS .In complex.h .Ft double complex .Fn ccosh "double complex z" .Ft float complex .Fn ccoshf "float complex z" .Ft double complex .Fn csinh "double complex z" .Ft float complex .Fn csinhf "float complex z" .Ft double complex .Fn ctanh "double complex z" .Ft float complex .Fn ctanhf "float complex z" .Sh DESCRIPTION The .Fn ccosh , .Fn csinh , and .Fn ctanh functions compute the hyperbolic cosine, sine, and tangent of the complex number .Fa z , respectively. The .Fn ccoshf , .Fn csinhf , and .Fn ctanhf functions perform the same operations in .Fa float precision. .Sh SEE ALSO .Xr cacosh 3 , .Xr ccos 3 , .Xr complex 3 , .Xr cosh 3 , .Xr math 3 , .Xr sinh 3 , .Xr tanh 3 .Sh STANDARDS These functions conform to .St -isoC-99 . diff --git a/lib/msun/man/exp.3 b/lib/msun/man/exp.3 index 2244bfac375a..ee43081bad83 100644 --- a/lib/msun/man/exp.3 +++ b/lib/msun/man/exp.3 @@ -1,197 +1,197 @@ .\" Copyright (c) 1985, 1991 Regents of the University of California. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" from: @(#)exp.3 6.12 (Berkeley) 7/31/91 .\" $FreeBSD$ .\" .Dd April 1, 2020 .Dt EXP 3 .Os .Sh NAME .Nm exp , .Nm expf , .Nm expl , .\" The sorting error is intentional. exp, expf, and expl should be adjacent. .Nm exp2 , .Nm exp2f , .Nm exp2l , .Nm expm1 , .Nm expm1f , .Nm expm1l , .Nm pow , .Nm powf , .Nm powl .Nd exponential and power functions .Sh LIBRARY .Lb libm .Sh SYNOPSIS .In math.h .Ft double .Fn exp "double x" .Ft float .Fn expf "float x" .Ft long double .Fn expl "long double x" .Ft double .Fn exp2 "double x" .Ft float .Fn exp2f "float x" .Ft long double .Fn exp2l "long double x" .Ft double .Fn expm1 "double x" .Ft float .Fn expm1f "float x" .Ft long double .Fn expm1l "long double x" .Ft double .Fn pow "double x" "double y" .Ft float .Fn powf "float x" "float y" .Ft long double .Fn powl "long double x" "long double y" .Sh DESCRIPTION The .Fn exp , .Fn expf , and .Fn expl functions compute the base .Ms e exponential value of the given argument .Fa x . .Pp The .Fn exp2 , .Fn exp2f , and .Fn exp2l functions compute the base 2 exponential of the given argument .Fa x . .Pp The .Fn expm1 , .Fn expm1f , and the .Fn expm1l functions compute the value exp(x)\-1 accurately even for tiny argument .Fa x . .Pp The .Fn pow , .Fn powf , and the .Fn powl functions compute the value of -.Ar x +.Fa x to the exponent -.Ar y . +.Fa y . .Sh ERROR (due to Roundoff etc.) The values of .Fn exp 0 , .Fn expm1 0 , .Fn exp2 integer , and .Fn pow integer integer are exact provided that they are representable. .\" XXX Is this really true for pow()? Otherwise the error in these functions is generally below one .Em ulp . .Sh RETURN VALUES These functions will return the appropriate computation unless an error occurs or an argument is out of range. The functions .Fn pow x y , .Fn powf x y , and .Fn powl x y raise an invalid exception and return an \*(Na if .Fa x < 0 and .Fa y is not an integer. .Sh NOTES The function .Fn pow x 0 returns x**0 = 1 for all x including x = 0, \*(If, and \*(Na . Previous implementations of pow may have defined x**0 to be undefined in some or all of these cases. Here are reasons for returning x**0 = 1 always: .Bl -enum -width indent .It Any program that already tests whether x is zero (or infinite or \*(Na) before computing x**0 cannot care whether 0**0 = 1 or not. Any program that depends upon 0**0 to be invalid is dubious anyway since that expression's meaning and, if invalid, its consequences vary from one computer system to another. .It Some Algebra texts (e.g.\& Sigler's) define x**0 = 1 for all x, including x = 0. This is compatible with the convention that accepts a[0] as the value of polynomial .Bd -literal -offset indent p(x) = a[0]\(**x**0 + a[1]\(**x**1 + a[2]\(**x**2 +...+ a[n]\(**x**n .Ed .Pp at x = 0 rather than reject a[0]\(**0**0 as invalid. .It Analysts will accept 0**0 = 1 despite that x**y can approach anything or nothing as x and y approach 0 independently. The reason for setting 0**0 = 1 anyway is this: .Bd -ragged -offset indent If x(z) and y(z) are .Em any functions analytic (expandable in power series) in z around z = 0, and if there x(0) = y(0) = 0, then x(z)**y(z) \(-> 1 as z \(-> 0. .Ed .It If 0**0 = 1, then \*(If**0 = 1/0**0 = 1 too; and then \*(Na**0 = 1 too because x**0 = 1 for all finite and infinite x, i.e., independently of x. .El .Sh SEE ALSO -.Xr clog 3 -.Xr cpow 3 +.Xr clog 3 , +.Xr cpow 3 , .Xr fenv 3 , .Xr ldexp 3 , .Xr log 3 , .Xr math 3 .Sh STANDARDS These functions conform to .St -isoC-99 . .Sh HISTORY The .Fn exp function appeared in .At v1 . diff --git a/lib/msun/man/sincos.3 b/lib/msun/man/sincos.3 index 7d44bea931b1..eecccf3cf37a 100644 --- a/lib/msun/man/sincos.3 +++ b/lib/msun/man/sincos.3 @@ -1,82 +1,82 @@ .\" Copyright (c) 2011 Steven G. Kargl. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" $FreeBSD$ .\" .Dd March 12, 2011 .Dt SINCOS 3 .Os .Sh NAME .Nm sincos , .Nm sincosf , .Nm sincosl .Nd sine and cosine functions .Sh LIBRARY .Lb libm .Sh SYNOPSIS .In math.h .Ft void .Fn sincos "double x" "double *s" "double *c" .Ft void .Fn sincosf "float x" "float *s" "float *c" .Ft void .Fn sincosl "long double x" "long double *s" "long double *c" .Sh DESCRIPTION The .Fn sincos , .Fn sincosf , and .Fn sincosl functions compute the sine and cosine of .Fa x . Using these functions allows argument reduction to occur only once instead of twice with individual invocations of .Fn sin and .Fn cos . Like .Fn sin and .Fn cos , a large magnitude argument may yield a result with little or no significance. .Sh RETURN VALUES Upon returning from .Fn sincos , .Fn sincosf , and .Fn sincosl , the memory pointed to by -.Ar "*s" +.Fa "*s" and -.Ar "*c" +.Fa "*c" are assigned the values of sine and cosine, respectively. .Sh SEE ALSO .Xr cos 3 , -.Xr sin 3 , +.Xr sin 3 .Sh HISTORY These functions were added to .Fx 9.0 to aid in writing various complex function contained in .St -isoC-99 . diff --git a/lib/msun/man/sqrt.3 b/lib/msun/man/sqrt.3 index bf6c3436cdbf..8214f8a2a7fb 100644 --- a/lib/msun/man/sqrt.3 +++ b/lib/msun/man/sqrt.3 @@ -1,125 +1,125 @@ .\" Copyright (c) 1985, 1991 Regents of the University of California. .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" from: @(#)sqrt.3 6.4 (Berkeley) 5/6/91 .\" $FreeBSD$ .\" .Dd February 15, 2020 .Dt SQRT 3 .Os .Sh NAME .Nm cbrt , .Nm cbrtf , .Nm cbrtl , .Nm sqrt , .Nm sqrtf , .Nm sqrtl .Nd cube root and square root functions .Sh LIBRARY .Lb libm .Sh SYNOPSIS .In math.h .Ft double .Fn cbrt "double x" .Ft float .Fn cbrtf "float x" .Ft long double .Fn cbrtl "long double x" .Ft double .Fn sqrt "double x" .Ft float .Fn sqrtf "float x" .Ft long double .Fn sqrtl "long double x" .Sh DESCRIPTION The .Fn cbrt , .Fn cbrtf , and .Fn cbrtl functions compute the cube root of -.Ar x . +.Fa x . .Pp The .Fn sqrt , .Fn sqrtf , and .Fn sqrtl functions compute the non-negative square root of -.Ar x . +.Fa x . .Sh RETURN VALUES The .Fn cbrt , .Fn cbrtf , and .Fn cbrtl functions return the requested cube root. The .Fn sqrt , .Fn sqrtf , and .Fn sqrtl functions return the requested square root unless an error occurs. An attempt to take the .Fn sqrt of negative .Fa x raises an invalid exception and causes an \*(Na to be returned (except that the square root of -0 is valid and equal to -0.) .Sh SEE ALSO .Xr fenv 3 , .Xr math 3 .Sh STANDARDS The .Fn cbrt , .Fn cbrtf , .Fn cbrtl , .Fn sqrt , .Fn sqrtf , and .Fn sqrtl functions conform to .St -isoC-99 . .Sh HISTORY The .Fn cbrt function appeared in .Bx 4.3 . The .Fn sqrt function appeared in .At v2 . .Fn sqrtl function appeared in .Fx 8.0 . The .Fn cbrtl function appeared in .Fx 9.0 .