diff options
Diffstat (limited to 'libm/man')
46 files changed, 0 insertions, 5387 deletions
diff --git a/libm/man/acos.3 b/libm/man/acos.3 deleted file mode 100644 index 9f03d60..0000000 --- a/libm/man/acos.3 +++ /dev/null @@ -1,92 +0,0 @@ -.\" 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. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. 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: src/lib/msun/man/acos.3,v 1.13 2005/01/14 23:28:28 das Exp $ -.\" -.Dd January 14, 2005 -.Dt ACOS 3 -.Os -.Sh NAME -.Nm acos , -.Nm acosf -.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" -.Sh DESCRIPTION -The -.Fn acos -and the -.Fn acosf -functions compute the principal value of the arc cosine of -.Fa x . -A domain error occurs for arguments not in the range -.Bq -1 , +1 . -For a discussion of error due to roundoff, see -.Xr math 3 . -.Sh RETURN VALUES -The -.Fn acos -and the -.Fn acosf -functions return the arc cosine in the range -.Bq 0 , \*(Pi -radians. -If: -.Bd -unfilled -offset indent -.Pf \&| Ns Ar 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 -function conforms to -.St -isoC . diff --git a/libm/man/acosh.3 b/libm/man/acosh.3 deleted file mode 100644 index 62534ab..0000000 --- a/libm/man/acosh.3 +++ /dev/null @@ -1,82 +0,0 @@ -.\" 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. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. 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: src/lib/msun/man/acosh.3,v 1.11 2005/01/14 23:28:28 das Exp $ -.\" -.Dd January 14, 2005 -.Dt ACOSH 3 -.Os -.Sh NAME -.Nm acosh , -.Nm acoshf -.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" -.Sh DESCRIPTION -The -.Fn acosh -and the -.Fn acoshf -functions compute the inverse hyperbolic cosine -of the real -argument -.Ar x . -For a discussion of error due to roundoff, see -.Xr math 3 . -.Sh RETURN VALUES -The -.Fn acosh -and the -.Fn acoshf -functions -return the inverse hyperbolic cosine of -.Ar 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 -function appeared in -.Bx 4.3 . diff --git a/libm/man/asin.3 b/libm/man/asin.3 deleted file mode 100644 index 1018990..0000000 --- a/libm/man/asin.3 +++ /dev/null @@ -1,94 +0,0 @@ -.\" 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. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. 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: src/lib/msun/man/asin.3,v 1.15 2005/01/14 23:28:28 das Exp $ -.\" -.Dd January 14, 2005 -.Dt ASIN 3 -.Os -.Sh NAME -.Nm asin , -.Nm asinf -.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" -.Sh DESCRIPTION -The -.Fn asin -and the -.Fn asinf -functions compute the principal value of the arc sine of -.Fa x . -A domain error occurs for arguments not in the range -.Bq -1 , +1 . -For a discussion of error due to roundoff, see -.Xr math 3 . -.Sh RETURN VALUES -The -.Fn asin -and the -.Fn asinf -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 -.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 -function conforms to -.St -isoC . diff --git a/libm/man/asinh.3 b/libm/man/asinh.3 deleted file mode 100644 index 6a0d9a0..0000000 --- a/libm/man/asinh.3 +++ /dev/null @@ -1,78 +0,0 @@ -.\" 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. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. 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: src/lib/msun/man/asinh.3,v 1.10 2001/10/13 12:23:22 bde Exp $ -.\" -.Dd May 6, 1991 -.Dt ASINH 3 -.Os -.Sh NAME -.Nm asinh , -.Nm asinhf -.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" -.Sh DESCRIPTION -The -.Fn asinh -and the -.Fn asinhf -functions compute the inverse hyperbolic sine -of the real -argument -.Ar x . -For a discussion of error due to roundoff, see -.Xr math 3 . -.Sh RETURN VALUES -The -.Fn asinh -and the -.Fn asinhf -functions -return the inverse hyperbolic sine of -.Ar x . -.Sh SEE ALSO -.Xr acosh 3 , -.Xr atanh 3 , -.Xr exp 3 , -.Xr math 3 -.Sh HISTORY -The -.Fn asinh -function appeared in -.Bx 4.3 . diff --git a/libm/man/atan.3 b/libm/man/atan.3 deleted file mode 100644 index c4cefed..0000000 --- a/libm/man/atan.3 +++ /dev/null @@ -1,84 +0,0 @@ -.\" 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. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. 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: @(#)atan.3 5.1 (Berkeley) 5/2/91 -.\" $FreeBSD: src/lib/msun/man/atan.3,v 1.10 2001/10/13 12:23:22 bde Exp $ -.\" -.Dd May 2, 1991 -.Dt ATAN 3 -.Os -.Sh NAME -.Nm atan , -.Nm atanf -.Nd arc tangent functions of one variable -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In math.h -.Ft double -.Fn atan "double x" -.Ft float -.Fn atanf "float x" -.Sh DESCRIPTION -The -.Fn atan -and the -.Fn atanf -functions compute the principal value of the arc tangent of -.Fa x . -For a discussion of error due to roundoff, see -.Xr math 3 . -.Sh RETURN VALUES -The -.Fn atan -and the -.Fn atanf -function returns the arc tangent in the range -.Bk -words -.Bq -\*(Pi/2 , +\*(Pi/2 -.Ek -radians. -.Sh SEE ALSO -.Xr acos 3 , -.Xr asin 3 , -.Xr atan2 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 atan -function conforms to -.St -isoC . diff --git a/libm/man/atan2.3 b/libm/man/atan2.3 deleted file mode 100644 index 421e17d..0000000 --- a/libm/man/atan2.3 +++ /dev/null @@ -1,187 +0,0 @@ -.\" 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. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. 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: src/lib/msun/man/atan2.3,v 1.14 2005/01/28 21:13:34 ru Exp $ -.\" -.Dd January 14, 2005 -.Dt ATAN2 3 -.Os -.Sh NAME -.Nm atan2 , -.Nm atan2f -.Nd arc tangent functions of two variables -.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" -.Sh DESCRIPTION -The -.Fn atan2 -and the -.Fn atan2f -functions compute the principal value of the arc tangent of -.Fa y/ Ns Ar x , -using the signs of both arguments to determine the quadrant of -the return value. -.Sh RETURN VALUES -The -.Fn atan2 -and the -.Fn atan2f -functions, if successful, -return the arc tangent of -.Fa y/ Ns Ar 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 -> 0, -.It Ta sign( Ns Ar y Ns )*(\*(Pi - -.Fn atan "\\*(Bay/x\\*(Ba" ) Ta -if -.Ar x -< 0, -.It Ta -.No 0 Ta -if x = y = 0, or -.It Ta -.Pf sign( Ar y Ns )*\\*(Pi/2 Ta -if -.Ar x -= 0 \(!= -.Ar 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 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 -function conforms to -.St -isoC . diff --git a/libm/man/atanh.3 b/libm/man/atanh.3 deleted file mode 100644 index 3dcc01a..0000000 --- a/libm/man/atanh.3 +++ /dev/null @@ -1,85 +0,0 @@ -.\" 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. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. 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: src/lib/msun/man/atanh.3,v 1.13 2005/01/28 21:14:16 ru Exp $ -.\" -.Dd January 14, 2005 -.Dt ATANH 3 -.Os -.Sh NAME -.Nm atanh , -.Nm atanhf -.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" -.Sh DESCRIPTION -The -.Fn atanh -and the -.Fn atanhf -functions compute the inverse hyperbolic tangent -of the real -argument -.Ar x . -For a discussion of error due to roundoff, see -.Xr math 3 . -.Sh RETURN VALUES -The -.Fn atanh -and the -.Fn atanhf -functions -return the inverse hyperbolic tangent of -.Ar 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| -> 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 -function appeared in -.Bx 4.3 . diff --git a/libm/man/ceil.3 b/libm/man/ceil.3 deleted file mode 100644 index 557903e..0000000 --- a/libm/man/ceil.3 +++ /dev/null @@ -1,82 +0,0 @@ -.\" 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. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. 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: @(#)ceil.3 5.1 (Berkeley) 5/2/91 -.\" $FreeBSD: src/lib/msun/man/ceil.3,v 1.15 2005/01/13 20:33:42 stefanf Exp $ -.\" -.Dd January 13, 2005 -.Dt CEIL 3 -.Os -.Sh NAME -.Nm ceil , -.Nm ceilf , -.Nm ceill -.Nd smallest integral value greater than or equal to x -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In math.h -.Ft double -.Fn ceil "double x" -.Ft float -.Fn ceilf "float x" -.Ft "long double" -.Fn ceill "long double x" -.Sh DESCRIPTION -The -.Fn ceil , -.Fn ceilf -and -.Fn ceill -functions return the smallest integral value -greater than or equal to -.Fa x , -expressed as a floating-point number. -.Sh SEE ALSO -.Xr abs 3 , -.Xr fabs 3 , -.Xr floor 3 , -.Xr ieee 3 , -.Xr math 3 , -.Xr rint 3 , -.Xr round 3 , -.Xr trunc 3 -.Sh STANDARDS -The -.Fn ceil -function conforms to -.St -isoC . -The -.Fn ceilf -and -.Fn ceill -functions conform to -.St -isoC-99 . diff --git a/libm/man/cimag.3 b/libm/man/cimag.3 deleted file mode 100644 index 069e848..0000000 --- a/libm/man/cimag.3 +++ /dev/null @@ -1,96 +0,0 @@ -.\" Copyright (c) 2004 Stefan Farfeleder -.\" 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: src/lib/msun/man/cimag.3,v 1.2 2005/01/13 10:43:01 ru Exp $ -.\" -.Dd August 7, 2004 -.Dt CIMAG 3 -.Os -.Sh NAME -.Nm cimag , cimagf , cimagl , -.Nm conj , conjf , conjl , -.Nm creal , crealf , creall -.Nd "functions to manipulate complex numbers" -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In complex.h -.Ft double -.Fn cimag "double complex z" -.Ft float -.Fn cimagf "float complex z" -.Ft "long double" -.Fn cimagl "long double complex z" -.Ft "double complex" -.Fn conj "double complex z" -.Ft "float complex" -.Fn conjf "float complex z" -.Ft "long double complex" -.Fn conjl "long double complex z" -.Ft double -.Fn creal "double complex z" -.Ft float -.Fn crealf "float complex z" -.Ft "long double" -.Fn creall "long double complex z" -.Sh DESCRIPTION -Let -.Sm off -.Fa a + b * Em i -.Sm on -denote the complex number -.Fa z . -.Pp -The -.Fn cimag -functions return the imaginary part -.Fa b . -.Pp -The -.Fn conj -functions return the complex conjugate -.Sm off -.Fa a - b * Em i . -.Sm on -.Pp -The -.Fn creal -functions return the real part -.Fa a . -.Sh STANDARDS -The -.Fn cimag , -.Fn conj -and -.Fn creal -functions conform to -.St -isoC-99 . -.Sh HISTORY -The -.Fn cimag , -.Fn conj -and -.Fn creal -functions first appeared in -.Fx 5.3 . diff --git a/libm/man/copysign.3 b/libm/man/copysign.3 deleted file mode 100644 index c3ce3dc..0000000 --- a/libm/man/copysign.3 +++ /dev/null @@ -1,90 +0,0 @@ -.\" 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. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. 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: @(#)ieee.3 6.4 (Berkeley) 5/6/91 -.\" $FreeBSD: src/lib/msun/man/copysign.3,v 1.1 2005/01/27 05:46:16 das Exp $ -.\" -.Dd January 26, 2005 -.Dt COPYSIGN 3 -.Os -.Sh NAME -.Nm copysign , -.Nm copysignf , -.Nm copysignl -.Nd copy sign -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In math.h -.Ft double -.Fn copysign "double x" "double y" -.Ft float -.Fn copysignf "float x" "float y" -.Ft long double -.Fn copysignl "long double x" "long double y" -.Sh DESCRIPTION -The -.Fn copysign , -.Fn copysignf -and -.Fn copysignl -functions -return -.Fa x -with its sign changed to -.Fa y Ns 's . -.Sh SEE ALSO -.Xr fabs 3 , -.Xr fdim 3 , -.Xr ieee 3 , -.Xr math 3 -.Sh STANDARDS -The -.Fn copysign , -.Fn copysignf , -and -.Fn copysignl -routines conform to -.St -isoC-99 . -They implement the Copysign function recommended by -.St -ieee754 . -.Sh HISTORY -The -.Fn copysign , -.Fn copysignf , -and -.Fn copysignl -functions appeared in -.Bx 4.3 , -.Fx 2.0 , -and -.Fx 5.3 , -respectively. diff --git a/libm/man/cos.3 b/libm/man/cos.3 deleted file mode 100644 index 8e0bd91..0000000 --- a/libm/man/cos.3 +++ /dev/null @@ -1,83 +0,0 @@ -.\" 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. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. 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: @(#)cos.3 5.1 (Berkeley) 5/2/91 -.\" $FreeBSD: src/lib/msun/man/cos.3,v 1.11 2001/10/13 12:23:23 bde Exp $ -.\" -.Dd May 2, 1991 -.Dt COS 3 -.Os -.Sh NAME -.Nm cos , -.Nm cosf -.Nd cosine functions -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In math.h -.Ft double -.Fn cos "double x" -.Ft float -.Fn cosf "float x" -.Sh DESCRIPTION -The -.Fn cos -and the -.Fn cosf -functions compute the cosine of -.Fa x -(measured in radians). -A large magnitude argument may yield a result with little or no -significance. -For a discussion of error due to roundoff, see -.Xr math 3 . -.Sh RETURN VALUES -The -.Fn cos -and the -.Fn cosf -functions return the cosine value. -.Sh SEE ALSO -.Xr acos 3 , -.Xr asin 3 , -.Xr atan 3 , -.Xr atan2 3 , -.Xr cosh 3 , -.Xr math 3 , -.Xr sin 3 , -.Xr sinh 3 , -.Xr tan 3 , -.Xr tanh 3 -.Sh STANDARDS -The -.Fn cos -function conforms to -.St -isoC . diff --git a/libm/man/cosh.3 b/libm/man/cosh.3 deleted file mode 100644 index 947c33e..0000000 --- a/libm/man/cosh.3 +++ /dev/null @@ -1,72 +0,0 @@ -.\" Copyright (c) 1989, 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. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. 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: @(#)cosh.3 5.1 (Berkeley) 5/2/91 -.\" $FreeBSD: src/lib/msun/man/cosh.3,v 1.12 2005/01/14 23:28:28 das Exp $ -.\" -.Dd January 14, 2005 -.Dt COSH 3 -.Os -.Sh NAME -.Nm cosh , -.Nm coshf -.Nd hyperbolic cosine functions -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In math.h -.Ft double -.Fn cosh "double x" -.Ft float -.Fn coshf "float x" -.Sh DESCRIPTION -The -.Fn cosh -and the -.Fn coshf -functions compute the hyperbolic cosine of -.Fa x . -.Sh SEE ALSO -.Xr acos 3 , -.Xr asin 3 , -.Xr atan 3 , -.Xr atan2 3 , -.Xr cos 3 , -.Xr math 3 , -.Xr sin 3 , -.Xr sinh 3 , -.Xr tan 3 , -.Xr tanh 3 -.Sh STANDARDS -The -.Fn cosh -function conforms to -.St -isoC . diff --git a/libm/man/erf.3 b/libm/man/erf.3 deleted file mode 100644 index 824787f..0000000 --- a/libm/man/erf.3 +++ /dev/null @@ -1,97 +0,0 @@ -.\" 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. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. 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: @(#)erf.3 6.4 (Berkeley) 4/20/91 -.\" $FreeBSD: src/lib/msun/man/erf.3,v 1.11 2004/07/02 23:52:20 ru Exp $ -.\" -.Dd April 20, 1991 -.Dt ERF 3 -.Os -.Sh NAME -.Nm erf , -.Nm erff , -.Nm erfc , -.Nm erfcf -.Nd error function operators -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In math.h -.Ft double -.Fn erf "double x" -.Ft float -.Fn erff "float x" -.Ft double -.Fn erfc "double x" -.Ft float -.Fn erfcf "float x" -.Sh DESCRIPTION -These functions calculate the error function of -.Fa x . -.Pp -The -.Fn erf -and the -.Fn erff -functions calculate the error function of x; where -.Bd -ragged -offset indent -.if n \{\ -erf(x) = 2/sqrt(pi)\(**\|integral from 0 to x of exp(\-t\(**t) dt. -\} -.if t \{\ -erf\|(x) := -(2/\(sr\(*p)\|\(is\d\s8\z0\s10\u\u\s8x\s10\d\|exp(\-t\u\s82\s10\d)\|dt. -\} -.Ed -.Pp -The -.Fn erfc -and the -.Fn erfcf -functions calculate the complementary error function of -.Fa x ; -that is -.Fn erfc -subtracts the result of the error function -.Fn erf x -from 1.0. -This is useful, since for large -.Fa x -places disappear. -.Sh SEE ALSO -.Xr math 3 -.Sh HISTORY -The -.Fn erf -and -.Fn erfc -functions appeared in -.Bx 4.3 . diff --git a/libm/man/exp.3 b/libm/man/exp.3 deleted file mode 100644 index f6aed8f..0000000 --- a/libm/man/exp.3 +++ /dev/null @@ -1,236 +0,0 @@ -.\" 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. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. 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: src/lib/msun/man/exp.3,v 1.22 2005/04/05 02:57:28 das Exp $ -.\" -.Dd April 5, 2005 -.Dt EXP 3 -.Os -.Sh NAME -.Nm exp , -.Nm expf , -.\" The sorting error is intentional. exp and expf should be adjacent. -.Nm exp2 , -.Nm exp2f , -.Nm expm1 , -.Nm expm1f , -.Nm log , -.Nm logf , -.Nm log10 , -.Nm log10f , -.Nm log1p , -.Nm log1pf , -.Nm pow , -.Nm powf -.Nd exponential, logarithm, power functions -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In math.h -.Ft double -.Fn exp "double x" -.Ft float -.Fn expf "float x" -.Ft double -.Fn exp2 "double x" -.Ft float -.Fn exp2f "float x" -.Ft double -.Fn expm1 "double x" -.Ft float -.Fn expm1f "float x" -.Ft double -.Fn log "double x" -.Ft float -.Fn logf "float x" -.Ft double -.Fn log10 "double x" -.Ft float -.Fn log10f "float x" -.Ft double -.Fn log1p "double x" -.Ft float -.Fn log1pf "float x" -.Ft double -.Fn pow "double x" "double y" -.Ft float -.Fn powf "float x" "float y" -.Sh DESCRIPTION -The -.Fn exp -and the -.Fn expf -functions compute the base -.Ms e -exponential value of the given argument -.Fa x . -.Pp -The -.Fn exp2 -and the -.Fn exp2f -functions compute the base 2 exponential of the given argument -.Fa x . -.Pp -The -.Fn expm1 -and the -.Fn expm1f -functions compute the value exp(x)\-1 accurately even for tiny argument -.Fa x . -.Pp -The -.Fn log -and the -.Fn logf -functions compute the value of the natural logarithm of argument -.Fa x . -.Pp -The -.Fn log10 -and the -.Fn log10f -functions compute the value of the logarithm of argument -.Fa x -to base 10. -.Pp -The -.Fn log1p -and the -.Fn log1pf -functions compute -the value of log(1+x) accurately even for tiny argument -.Fa x . -.Pp -The -.Fn pow -and the -.Fn powf -functions compute the value -of -.Ar x -to the exponent -.Ar 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 -and -.Fn powf x y -raise an invalid exception and return an \*(Na if -.Fa x -< 0 and -.Fa y -is not an integer. -An attempt to take the logarithm of \*(Pm0 will result in -a divide-by-zero exception, and an infinity will be returned. -An attempt to take the logarithm of a negative number will -result in an invalid exception, and an \*(Na will be generated. -.Sh NOTES -The functions exp(x)\-1 and log(1+x) are called -expm1 and logp1 in -.Tn BASIC -on the Hewlett\-Packard -.Tn HP Ns \-71B -and -.Tn APPLE -Macintosh, -.Tn EXP1 -and -.Tn LN1 -in Pascal, exp1 and log1 in C -on -.Tn APPLE -Macintoshes, where they have been provided to make -sure financial calculations of ((1+x)**n\-1)/x, namely -expm1(n\(**log1p(x))/x, will be accurate when x is tiny. -They also provide accurate inverse hyperbolic functions. -.Pp -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 fenv 3 , -.Xr math 3 diff --git a/libm/man/fabs.3 b/libm/man/fabs.3 deleted file mode 100644 index 56b3a23..0000000 --- a/libm/man/fabs.3 +++ /dev/null @@ -1,87 +0,0 @@ -.\" Copyright (c) 1991 The Regents of the University of California. -.\" All rights reserved. -.\" -.\" @(#)fabs.3 5.1 (Berkeley) 5/2/91 -.\" 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. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. 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: @(#)fabs.3 5.1 (Berkeley) 5/2/91 -.\" $FreeBSD: src/lib/msun/man/fabs.3,v 1.11 2004/07/01 18:20:57 ru Exp $ -.\" -.Dd October 25, 2003 -.Dt FABS 3 -.Os -.Sh NAME -.Nm fabs , -.Nm fabsf , -.Nm fabsl -.Nd floating-point absolute value functions -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In math.h -.Ft double -.Fn fabs "double x" -.Ft float -.Fn fabsf "float x" -.Ft long double -.Fn fabsl "long double x" -.Sh DESCRIPTION -The -.Fn fabs , -.Fn fabsf -and -.Fn fabsl -functions compute the absolute value of a floating-point number -.Fa x . -.Sh RETURN VALUES -The -.Fn fabs , -.Fn fabsf -and -.Fn fabsl -functions return the absolute value of -.Fa x . -.Sh SEE ALSO -.Xr abs 3 , -.Xr ceil 3 , -.Xr floor 3 , -.Xr ieee 3 , -.Xr math 3 , -.Xr rint 3 -.Sh STANDARDS -The -.Fn fabs -function conforms to -.St -isoC . -The -.Fn fabsf -and -.Fn fabsl -functions conform to -.St -isoC-99 . diff --git a/libm/man/fdim.3 b/libm/man/fdim.3 deleted file mode 100644 index ca4e5ec..0000000 --- a/libm/man/fdim.3 +++ /dev/null @@ -1,86 +0,0 @@ -.\" Copyright (c) 2004 David Schultz <das@FreeBSD.org> -.\" 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: src/lib/msun/man/fdim.3,v 1.1 2004/06/30 07:04:01 das Exp $ -.\" -.Dd June 29, 2004 -.Dt FDIM 3 -.Os -.Sh NAME -.Nm fdim , -.Nm fdimf , -.Nm fdiml -.Nd positive difference functions -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In math.h -.Ft double -.Fn fdim "double x" "double y" -.Ft float -.Fn fdimf "float x" "float y" -.Ft long double -.Fn fdiml "long double x" "long double y" -.Sh DESCRIPTION -The -.Fn fdim , -.Fn fdimf , -and -.Fn fdiml -functions return the positive difference between -.Fa x -and -.Fa y . -That is, if -.Fa x\- Ns Fa y -is positive, then -.Fa x\- Ns Fa y -is returned. -If either -.Fa x -or -.Fa y -is an \*(Na, then an \*(Na is returned. -Otherwise, the result is -.Li +0.0 . -.Pp -Overflow or underflow may occur iff the exact result is not -representable in the return type. -No other exceptions are raised. -.Sh SEE ALSO -.Xr fabs 3 , -.Xr fmax 3 , -.Xr fmin 3 , -.Xr math 3 -.Sh STANDARDS -The -.Fn fdim , -.Fn fdimf , -and -.Fn fdiml -functions conform to -.St -isoC-99 . -.Sh HISTORY -These routines first appeared in -.Fx 5.3 . diff --git a/libm/man/feclearexcept.3 b/libm/man/feclearexcept.3 deleted file mode 100644 index 073de67..0000000 --- a/libm/man/feclearexcept.3 +++ /dev/null @@ -1,139 +0,0 @@ -.\" Copyright (c) 2004 David Schultz <das@FreeBSD.org> -.\" 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: src/lib/msun/man/feclearexcept.3,v 1.3 2005/01/14 09:12:05 ru Exp $ -.\" -.Dd May 8, 2004 -.Dt FECLEAREXCEPT 3 -.Os -.Sh NAME -.Nm feclearexcept , -.Nm fegetexceptflag , -.Nm feraiseexcept , -.Nm fesetexceptflag , -.Nm fetestexcept -.Nd floating-point exception flag manipulation -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In fenv.h -.Fd "#pragma STDC FENV_ACCESS ON" -.Ft int -.Fn feclearexcept "int excepts" -.Ft int -.Fn fegetexceptflag "fexcept_t *flagp" "int excepts" -.Ft int -.Fn feraiseexcept "int excepts" -.Ft int -.Fn fesetexceptflag "const fexcept_t *flagp" "int excepts" -.Ft int -.Fn fetestexcept "int excepts" -.Sh DESCRIPTION -The -.Fn feclearexcept -routine clears the floating-point exception flags specified by -.Fa excepts , -whereas -.Fn feraiseexcept -raises the specified exceptions. -Raising an exception causes the corresponding flag to be set, -and a -.Dv SIGFPE -is delivered to the process if the exception is unmasked. -.Pp -The -.Fn fetestexcept -function determines which flags are currently set, of those specified by -.Fa excepts . -.Pp -The -.Fn fegetexceptflag -function stores the state of the exception flags specified in -.Fa excepts -in the opaque object pointed to by -.Fa flagp . -Similarly, -.Fn fesetexceptflag -changes the specified exception flags to reflect the state stored in -the object pointed to by -.Fa flagp . -Note that the flags restored with -.Fn fesetexceptflag -must be a (not necessarily proper) subset of the flags recorded by -a prior call to -.Fn fegetexceptflag . -.Pp -For all of these functions, the possible types of exceptions -include those described in -.Xr fenv 3 . -Some architectures may define other types of floating-point exceptions. -.Sh IMPLEMENTATION NOTES -On some architectures, raising an overflow or underflow exception -also causes an inexact exception to be raised. -In these cases, the overflow or underflow will be raised first. -.Pp -The -.Fn fegetexceptflag -and -.Fn fesetexceptflag -routines are preferred to -.Fn fetestexcept -and -.Fn feraiseexcept , -respectively, for saving and restoring exception flags. -The latter do not re-raise exceptions and may preserve -architecture-specific information such as addresses where -exceptions occurred. -.Sh RETURN VALUES -The -.Fn feclearexcept , -.Fn fegetexceptflag , -.Fn feraiseexcept , -and -.Fn fesetexceptflag -functions return 0 upon success, and non-zero otherwise. -The -.Fn fetestexcept -function returns the bitwise OR of the values of the current exception -flags that were requested. -.Sh SEE ALSO -.Xr sigaction 2 , -.Xr feholdexcept 3 , -.Xr fenv 3 , -.Xr feupdateenv 3 , -.Xr fpgetsticky 3 , -.Xr fpresetsticky 3 -.Sh STANDARDS -The -.Fn feclearexcept , -.Fn fegetexceptflag , -.Fn feraiseexcept , -.Fn fesetexceptflag , -and -.Fn fetestexcept -routines conform to -.St -isoC-99 . -.Sh HISTORY -These functions first appeared in -.Fx 5.3 . diff --git a/libm/man/feenableexcept.3 b/libm/man/feenableexcept.3 deleted file mode 100644 index 0b790e7..0000000 --- a/libm/man/feenableexcept.3 +++ /dev/null @@ -1,98 +0,0 @@ -.\" Copyright (c) 2004 David Schultz <das@FreeBSD.org> -.\" 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: src/lib/msun/man/feenableexcept.3,v 1.1 2005/03/16 19:04:28 das Exp $ -.\" -.Dd March 16, 2005 -.Dt FEENABLEEXCEPT 3 -.Os -.Sh NAME -.Nm feenableexcept , -.Nm fedisableexcept , -.Nm fegetexcept -.Nd floating-point exception masking -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In fenv.h -.Fd "#pragma STDC FENV_ACCESS ON" -.Ft int -.Fn feenableexcept "int excepts" -.Ft int -.Fn fedisableexcept "int excepts" -.Ft int -.Fn fegetexcept "void" -.Sh DESCRIPTION -The -.Fn feenableexcept -and -.Fn fedisableexcept -functions -unmask and mask (respectively) exceptions specified in -.Fa excepts . -The -.Fn fegetexcept -function -returns the current exception mask. -All exceptions are masked by default. -.Pp -Floating-point operations that produce unmasked exceptions will trap, and a -.Dv SIGFPE -will be delivered to the process. -By installing a signal handler for -.Dv SIGFPE , -applications can take appropriate action immediately without -testing the exception flags after every operation. -Note that the trap may not be immediate, but it should occur -before the next floating-point instruction is executed. -.Pp -For all of these functions, the possible types of exceptions -include those described in -.Xr fenv 3 . -Some architectures may define other types of floating-point exceptions. -.Sh RETURN VALUES -The -.Fn feenableexcept , -.Fn fedisableexcept , -and -.Fn fegetexcept -functions return a bitmap of the exceptions that were unmasked -prior to the call. -.Sh SEE ALSO -.Xr sigaction 2 , -.Xr feclearexcept 3 , -.Xr feholdexcept 3 , -.Xr fenv 3 , -.Xr feupdateenv 3 -.Sh BUGS -Functions in the standard library may trigger exceptions multiple -times as a result of intermediate computations; -however, they generally do not trigger spurious exceptions. -.Pp -No interface is provided to permit exceptions to be handled in -nontrivial ways. -There is no uniform way for an exception handler to access -information about the exception-causing instruction, or -to determine whether that instruction should be reexecuted -after returning from the handler. diff --git a/libm/man/fegetenv.3 b/libm/man/fegetenv.3 deleted file mode 100644 index 2e386ad..0000000 --- a/libm/man/fegetenv.3 +++ /dev/null @@ -1,113 +0,0 @@ -.\" Copyright (c) 2004 David Schultz <das@FreeBSD.org> -.\" 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: src/lib/msun/man/fegetenv.3,v 1.1 2004/06/06 10:06:26 das Exp $ -.\" -.Dd May 8, 2004 -.Dt FEGETENV 3 -.Os -.Sh NAME -.Nm fegetenv , -.Nm feholdexcept , -.Nm fesetenv , -.Nm feupdateenv -.Nd floating-point environment save and restore -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In fenv.h -.Fd "#pragma STDC FENV_ACCESS ON" -.Ft int -.Fn fegetenv "fenv_t *envp" -.Ft int -.Fn feholdexcept "fenv_t *envp" -.Ft int -.Fn fesetenv "const fenv_t *envp" -.Ft int -.Fn feupdateenv "const fenv_t *envp" -.Sh DESCRIPTION -The floating-point environment includes exception flags and masks, the -current rounding mode, and other architecture-specific settings. -However, it does not include the floating-point register file. -.Pp -The -.Fn fegetenv -function stores the current floating-point environment in the object -pointed to by -.Fa envp , -whereas -.Fn feholdexcept -saves the current environment, then clears all exception flags -and masks all floating-point exceptions. -.Pp -The -.Fn fesetenv -function restores a previously saved environment. -The -.Fn feupdateenv -function restores a saved environment as well, but it also -raises any exceptions that were set in the environment it -replaces. -.Pp -The -.Fn feholdexcept -function is often used with -.Fn feupdateenv -or -.Fn fesetenv -to suppress spurious exceptions that occur as a result of -intermediate computations. -An example in -.Xr fenv 3 -demonstrates how to do this. -.Sh RETURN VALUES -The -.Fn fegetenv , -.Fn feholdexcept , -.Fn fesetenv , -and -.Fn feupdateenv -functions return 0 if they succeed, and non-zero otherwise. -.Sh SEE ALSO -.Xr feclearexcept 3 , -.Xr fenv 3 , -.Xr feraiseexcept 3 , -.Xr fesetenv 3 , -.Xr fetestexcept 3 , -.Xr fpgetmask 3 , -.Xr fpgetprec 3 , -.Xr fpsetmask 3 , -.Xr fpsetprec 3 -.Sh STANDARDS -The -.Fn fegetenv , -.Fn feholdexcept , -.Fn fesetenv , -and -.Fn feupdateenv -functions conform to -.St -isoC-99 . -.Sh HISTORY -These routines first appeared in -.Fx 5.3 . diff --git a/libm/man/fegetround.3 b/libm/man/fegetround.3 deleted file mode 100644 index 9384158..0000000 --- a/libm/man/fegetround.3 +++ /dev/null @@ -1,83 +0,0 @@ -.\" Copyright (c) 2004 David Schultz <das@FreeBSD.org> -.\" 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: src/lib/msun/man/fegetround.3,v 1.2 2005/01/14 09:12:05 ru Exp $ -.\" -.Dd May 8, 2004 -.Dt FEGETROUND 3 -.Os -.Sh NAME -.Nm fegetround , -.Nm fesetround -.Nd floating-point rounding control -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In fenv.h -.Fd "#pragma STDC FENV_ACCESS ON" -.Ft int -.Fn fegetround void -.Ft int -.Fn fesetround "int round" -.Sh DESCRIPTION -The -.Fn fegetround -function determines the current floating-point rounding mode, -and the -.Fn fesetround -function sets the current rounding mode to -.Fa round . -The rounding mode is one of -.Dv FE_TONEAREST , FE_DOWNWARD , FE_UPWARD , -or -.Dv FE_TOWARDZERO , -as described in -.Xr fenv 3 . -.Sh RETURN VALUES -The -.Fn fegetround -routine returns the current rounding mode. -The -.Fn fesetround -function returns 0 on success and non-zero otherwise; -however, the present implementation always succeeds. -.Sh SEE ALSO -.Xr fenv 3 , -.Xr fpgetround 3 , -.Xr fpsetround 3 -.Sh STANDARDS -The -.Fn fegetround -and -.Fn fesetround -functions conform to -.St -isoC-99 . -.Sh HISTORY -These routines first appeared in -.Fx 5.3 . -They supersede the non-standard -.Xr fpgetround 3 -and -.Xr fpsetround 3 -functions. diff --git a/libm/man/fenv.3 b/libm/man/fenv.3 deleted file mode 100644 index 33ad541..0000000 --- a/libm/man/fenv.3 +++ /dev/null @@ -1,289 +0,0 @@ -.\" Copyright (c) 2004 David Schultz <das@FreeBSD.org> -.\" 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: src/lib/msun/man/fenv.3,v 1.5 2005/06/15 19:04:04 ru Exp $ -.\" -.Dd March 16, 2005 -.Dt FENV 3 -.Os -.Sh NAME -.Nm feclearexcept , -.Nm fegetexceptflag , -.Nm feraiseexcept , -.Nm fesetexceptflag , -.Nm fetestexcept , -.Nm fegetround , -.Nm fesetround , -.Nm fegetenv , -.Nm feholdexcept , -.Nm fesetenv , -.Nm feupdateenv , -.Nm feenableexcept , -.Nm fedisableexcept , -.Nm fegetexcept -.Nd floating-point environment control -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In fenv.h -.Fd "#pragma STDC FENV_ACCESS ON" -.Ft int -.Fn feclearexcept "int excepts" -.Ft int -.Fn fegetexceptflag "fexcept_t *flagp" "int excepts" -.Ft int -.Fn feraiseexcept "int excepts" -.Ft int -.Fn fesetexceptflag "const fexcept_t *flagp" "int excepts" -.Ft int -.Fn fetestexcept "int excepts" -.Ft int -.Fn fegetround void -.Ft int -.Fn fesetround "int round" -.Ft int -.Fn fegetenv "fenv_t *envp" -.Ft int -.Fn feholdexcept "fenv_t *envp" -.Ft int -.Fn fesetenv "const fenv_t *envp" -.Ft int -.Fn feupdateenv "const fenv_t *envp" -.Ft int -.Fn feenableexcept "int excepts" -.Ft int -.Fn fedisableexcept "int excepts" -.Ft int -.Fn fegetexcept void -.Sh DESCRIPTION -The -.In fenv.h -routines manipulate the floating-point environment, -which includes the exception flags and rounding modes defined in -.St -ieee754 . -.Ss Exceptions -Exception flags are set as side-effects of floating-point arithmetic -operations and math library routines, and they remain set until -explicitly cleared. -The following macros expand to bit flags of type -.Vt int -representing the five standard floating-point exceptions. -.Bl -tag -width ".Dv FE_DIVBYZERO" -.It Dv FE_DIVBYZERO -A divide-by-zero exception occurs when the program attempts to -divide a finite non-zero number by zero. -.It Dv FE_INEXACT -An inexact exception is raised whenever there is a loss of precision -due to rounding. -.It Dv FE_INVALID -Invalid operation exceptions occur when a program attempts to -perform calculations for which there is no reasonable representable -answer. -For instance, subtraction of infinities, division of zero by zero, -ordered comparison involving \*(Nas, and taking the square root of a -negative number are all invalid operations. -.It Dv FE_OVERFLOW -An overflow exception occurs when the magnitude of the result of a -computation is too large to fit in the destination type. -.It Dv FE_UNDERFLOW -Underflow occurs when the result of a computation is too close to zero -to be represented as a non-zero value in the destination type. -.El -.Pp -Additionally, the -.Dv FE_ALL_EXCEPT -macro expands to the bitwise OR of the above flags and any -architecture-specific flags. -Combinations of these flags are passed to the -.Fn feclearexcept , -.Fn fegetexceptflag , -.Fn feraiseexcept , -.Fn fesetexceptflag , -and -.Fn fetestexcept -functions to clear, save, raise, restore, and examine the -processor's floating-point exception flags, respectively. -.Pp -Exceptions may be -.Em unmasked -with -.Fn feenableexcept -and masked with -.Fn fedisableexcept . -Unmasked exceptions cause a trap when they are produced, and -all exceptions are masked by default. -The current mask can be tested with -.Fn fegetexcept . -.Ss Rounding Modes -.St -ieee754 -specifies four rounding modes. -These modes control the direction in which results are rounded -from their exact values in order to fit them into binary -floating-point variables. -The four modes correspond with the following symbolic constants. -.Bl -tag -width ".Dv FE_TOWARDZERO" -.It Dv FE_TONEAREST -Results are rounded to the closest representable value. -If the exact result is exactly half way between two representable -values, the value whose last binary digit is even (zero) is chosen. -This is the default mode. -.It Dv FE_DOWNWARD -Results are rounded towards negative \*[If]. -.It Dv FE_UPWARD -Results are rounded towards positive \*[If]. -.It Dv FE_TOWARDZERO -Results are rounded towards zero. -.El -.Pp -The -.Fn fegetround -and -.Fn fesetround -functions query and set the rounding mode. -.Ss Environment Control -The -.Fn fegetenv -and -.Fn fesetenv -functions save and restore the floating-point environment, -which includes exception flags, the current exception mask, -the rounding mode, and possibly other implementation-specific -state. -The -.Fn feholdexcept -function behaves like -.Fn fegetenv , -but with the additional effect of clearing the exception flags and -installing a -.Em non-stop -mode. -In non-stop mode, floating-point operations will set exception flags -as usual, but no -.Dv SIGFPE -signals will be generated as a result. -Non-stop mode is the default, but it may be altered by -non-standard mechanisms. -.\" XXX Mention fe[gs]etmask() here after the interface is finalized -.\" XXX and ready to be officially documented. -The -.Fn feupdateenv -function restores a saved environment similarly to -.Fn fesetenv , -but it also re-raises any floating-point exceptions from the old -environment. -.Pp -The macro -.Dv FE_DFL_ENV -expands to a pointer to the default environment. -.Sh CAVEATS -The FENV_ACCESS pragma can be enabled with -.Dl "#pragma STDC FENV_ACCESS ON" -and disabled with the -.Dl "#pragma STDC FENV_ACCESS OFF" -directive. -This lexically-scoped annotation tells the compiler that the program -may access the floating-point environment, so optimizations that would -violate strict IEEE-754 semantics are disabled. -If execution reaches a block of code for which -.Dv FENV_ACCESS -is off, the floating-point environment will become undefined. -.Sh EXAMPLES -The following routine computes the square root function. -It explicitly raises an invalid exception on appropriate inputs using -.Fn feraiseexcept . -It also defers inexact exceptions while it computes intermediate -values, and then it allows an inexact exception to be raised only if -the final answer is inexact. -.Bd -literal -offset indent -#pragma STDC FENV_ACCESS ON -double sqrt(double n) { - double x = 1.0; - fenv_t env; - - if (isnan(n) || n < 0.0) { - feraiseexcept(FE_INVALID); - return (NAN); - } - if (isinf(n) || n == 0.0) - return (n); - feholdexcept(&env); - while (fabs((x * x) - n) > DBL_EPSILON * 2 * x) - x = (x / 2) + (n / (2 * x)); - if (x * x == n) - feclearexcept(FE_INEXACT); - feupdateenv(&env); - return (x); -} -.Ed -.Sh SEE ALSO -.Xr cc 1 , -.Xr feclearexcept 3 , -.Xr fedisableexcept 3 , -.Xr feenableexcept 3 , -.Xr fegetenv 3 , -.Xr fegetexcept 3 , -.Xr fegetexceptflag 3 , -.Xr fegetround 3 , -.Xr feholdexcept 3 , -.Xr feraiseexcept 3 , -.Xr fesetenv 3 , -.Xr fesetexceptflag 3 , -.Xr fesetround 3 , -.Xr fetestexcept 3 , -.Xr feupdateenv 3 , -.Xr fpgetprec 3 , -.Xr fpsetprec 3 -.Sh STANDARDS -Except as noted below, -.In fenv.h -conforms to -.St -isoC-99 . -The -.Fn feenableexcept , -.Fn fedisableexcept , -and -.Fn fegetexcept -routines are extensions. -.Sh HISTORY -The -.In fenv.h -header first appeared in -.Fx 5.3 . -It supersedes the non-standard routines defined in -.In ieeefp.h -and documented in -.Xr fpgetround 3 . -.Sh BUGS -The -.Dv FENV_ACCESS -pragma is unimplemented in the system compiler. -However, non-constant expressions generally produce the correct -side-effects at low optimization levels. -.Pp -On the Alpha platform, -.Xr cc 1 -must be passed the -.Fl mieee-with-inexact mfp-rounding-mode=d -options in order to generate code that has the standard -side-effects and uses the specified rounding modes. diff --git a/libm/man/floor.3 b/libm/man/floor.3 deleted file mode 100644 index 1f02daf..0000000 --- a/libm/man/floor.3 +++ /dev/null @@ -1,82 +0,0 @@ -.\" Copyright (c) 1985, 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. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. 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: @(#)floor.3 6.5 (Berkeley) 4/19/91 -.\" $FreeBSD: src/lib/msun/man/floor.3,v 1.17 2005/01/13 09:35:47 ru Exp $ -.\" -.Dd January 13, 2005 -.Dt FLOOR 3 -.Os -.Sh NAME -.Nm floor , -.Nm floorf , -.Nm floorl -.Nd largest integral value less than or equal to x -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In math.h -.Ft double -.Fn floor "double x" -.Ft float -.Fn floorf "float x" -.Ft "long double" -.Fn floorl "long double x" -.Sh DESCRIPTION -The -.Fn floor , -.Fn floorf -and -.Fn floorl -functions return the largest integral value -less than or equal to -.Fa x , -expressed as a floating-point number. -.Sh SEE ALSO -.Xr abs 3 , -.Xr ceil 3 , -.Xr fabs 3 , -.Xr ieee 3 , -.Xr math 3 , -.Xr rint 3 , -.Xr round 3 , -.Xr trunc 3 -.Sh STANDARDS -The -.Fn floor -function conforms to -.St -isoC . -The -.Fn floorf -and -.Fn floorl -functions conform to -.St -isoC-99 . diff --git a/libm/man/fma.3 b/libm/man/fma.3 deleted file mode 100644 index 078a6e2..0000000 --- a/libm/man/fma.3 +++ /dev/null @@ -1,116 +0,0 @@ -.\" Copyright (c) 2005 David Schultz <das@FreeBSD.org> -.\" 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: src/lib/msun/man/fma.3,v 1.3 2005/11/24 09:25:10 joel Exp $ -.\" -.Dd January 22, 2005 -.Dt FMA 3 -.Os -.Sh NAME -.Nm fma , -.Nm fmaf , -.Nm fmal -.Nd fused multiply-add -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In math.h -.Ft double -.Fn fma "double x" "double y" "double z" -.Ft float -.Fn fmaf "float x" "float y" "float z" -.Ft long double -.Fn fmal "long double x" "long double y" "long double z" -.Sh DESCRIPTION -The -.Fn fma , -.Fn fmaf , -and -.Fn fmal -functions return -.No "(x * y) + z" , -computed with only one rounding error. -Using the ordinary multiplication and addition operators, by contrast, -results in two roundings: one for the intermediate product and one for -the final result. -.Pp -For instance, the expression -.No "1.2e100 * 2.0e208 - 1.4e308" -produces \*(If due to overflow in the intermediate product, whereas -.No "fma(1.2e100, 2.0e208, -1.4e308)" -returns approximately 1.0e308. -.Pp -The fused multiply-add operation is often used to improve the -accuracy of calculations such as dot products. -It may also be used to improve performance on machines that implement -it natively. -The macros -.Dv FP_FAST_FMA , -.Dv FP_FAST_FMAF -and -.Dv FP_FAST_FMAL -may be defined in -.In math.h -to indicate that -.Fn fma , -.Fn fmaf , -and -.Fn fmal -(respectively) have comparable or faster speed than a multiply -operation followed by an add operation. -.Sh IMPLEMENTATION NOTES -In general, these routines will behave as one would expect if -.No "x * y + z" -were computed with unbounded precision and range, -then rounded to the precision of the return type. -However, on some platforms, if -.Fa z -is \*(Na, these functions may not raise an exception even -when the computation of -.No "x * y" -would have otherwise generated an invalid exception. -.Sh SEE ALSO -.Xr fenv 3 , -.Xr math 3 -.Sh STANDARDS -The -.Fn fma , -.Fn fmaf , -and -.Fn fmal -functions conform to -.St -isoC-99 . -A fused multiply-add operation with virtually identical -characteristics appears in IEEE draft standard 754R. -.Sh HISTORY -The -.Fn fma -and -.Fn fmaf -routines first appeared in -.Fx 5.4 , -and -.Fn fmal -appeared in -.Fx 6.0 . diff --git a/libm/man/fmax.3 b/libm/man/fmax.3 deleted file mode 100644 index 03249a3..0000000 --- a/libm/man/fmax.3 +++ /dev/null @@ -1,97 +0,0 @@ -.\" Copyright (c) 2004 David Schultz <das@FreeBSD.org> -.\" 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: src/lib/msun/man/fmax.3,v 1.2 2005/01/14 09:12:05 ru Exp $ -.\" -.Dd June 29, 2004 -.Dt FMAX 3 -.Os -.Sh NAME -.Nm fmax , -.Nm fmaxf , -.Nm fmaxl , -.Nm fmin , -.Nm fminf , -.Nm fminl -.Nd floating-point maximum and minimum functions -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In math.h -.Ft double -.Fn fmax "double x" "double y" -.Ft float -.Fn fmaxf "float x" "float y" -.Ft "long double" -.Fn fmaxl "long double x" "long double y" -.Ft double -.Fn fmin "double x" "double y" -.Ft float -.Fn fminf "float x" "float y" -.Ft "long double" -.Fn fminl "long double x" "long double y" -.Sh DESCRIPTION -The -.Fn fmax , -.Fn fmaxf , -and -.Fn fmaxl -functions return the larger of -.Fa x -and -.Fa y , -and likewise, the -.Fn fmin , -.Fn fminf , -and -.Fn fminl -functions return the smaller of -.Fa x -and -.Fa y . -They treat -.Li +0.0 -as being larger than -.Li -0.0 . -If one argument is an \*(Na, then the other argument is returned. -If both arguments are \*(Nas, then the result is an \*(Na. -These routines do not raise any floating-point exceptions. -.Sh SEE ALSO -.Xr fabs 3 , -.Xr fdim 3 , -.Xr math 3 -.Sh STANDARDS -The -.Fn fmax , -.Fn fmaxf , -.Fn fmaxl , -.Fn fmin , -.Fn fminf , -and -.Fn fminl -functions conform to -.St -isoC-99 . -.Sh HISTORY -These routines first appeared in -.Fx 5.3 . diff --git a/libm/man/fmod.3 b/libm/man/fmod.3 deleted file mode 100644 index c0d4ed8..0000000 --- a/libm/man/fmod.3 +++ /dev/null @@ -1,87 +0,0 @@ -.\" 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. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. 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: @(#)fmod.3 5.1 (Berkeley) 5/2/91 -.\" $FreeBSD: src/lib/msun/man/fmod.3,v 1.8 2001/10/13 12:23:23 bde Exp $ -.\" -.Dd May 2, 1991 -.Dt FMOD 3 -.Os -.Sh NAME -.Nm fmod , -.Nm fmodf -.Nd floating-point remainder functions -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In math.h -.Ft double -.Fn fmod "double x" "double y" -.Ft float -.Fn fmodf "float x" "float y" -.Sh DESCRIPTION -The -.Fn fmod -and the -.Fn fmodf -functions compute the floating-point remainder of -.Fa x Ns / Fa y . -.Sh RETURN VALUES -The -.Fn fmod -and the -.Fn fmodf -functions return the value -.Sm off -.Fa x - Em i * Fa y , -.Sm on -for some integer -.Em i -such that, if -.Fa y -is non-zero, the result has the same sign as -.Fa x -and magnitude less than the magnitude of -.Fa y . -If -.Fa y -is zero, whether a domain error occurs or the -.Fn fmod -and the -.Fn fmodf -function returns zero is implementation-defined. -.Sh SEE ALSO -.Xr math 3 -.Sh STANDARDS -The -.Fn fmod -function conforms to -.St -isoC . diff --git a/libm/man/hypot.3 b/libm/man/hypot.3 deleted file mode 100644 index a92a2a6..0000000 --- a/libm/man/hypot.3 +++ /dev/null @@ -1,134 +0,0 @@ -.\" 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. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. 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: @(#)hypot.3 6.7 (Berkeley) 5/6/91 -.\" $FreeBSD: src/lib/msun/man/hypot.3,v 1.13 2005/01/14 23:28:28 das Exp $ -.\" -.Dd January 14, 2005 -.Dt HYPOT 3 -.Os -.Sh NAME -.Nm hypot , -.Nm hypotf , -.Nm cabs , -.Nm cabsf -.Nd Euclidean distance and complex absolute value functions -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In math.h -.Ft double -.Fn hypot "double x" "double y" -.Ft float -.Fn hypotf "float x" "float y" -.In complex.h -.Ft double -.Fn cabs "double complex z" -.Ft float -.Fn cabsf "float complex z" -.Sh DESCRIPTION -The -.Fn hypot -and -.Fn hypotf -functions -compute the -sqrt(x*x+y*y) -in such a way that underflow will not happen, and overflow -occurs only if the final result deserves it. -The -.Fn cabs -and -.Fn cabsf -functions compute the complex absolute value of -.Fa z . -.Pp -.Fn hypot "\*(If" "v" -= -.Fn hypot "v" "\*(If" -= +\*(If for all -.Fa v , -including \*(Na. -.Sh ERROR (due to Roundoff, etc.) -Below 0.97 -.Em ulps . -Consequently -.Fn hypot "5.0" "12.0" -= 13.0 -exactly; -in general, hypot and cabs return an integer whenever an -integer might be expected. -.Pp -The same cannot be said for the shorter and faster version of hypot -and cabs that is provided in the comments in cabs.c; its error can -exceed 1.2 -.Em ulps . -.Sh NOTES -As might be expected, -.Fn hypot "v" "\*(Na" -and -.Fn hypot "\*(Na" "v" -are \*(Na for all -.Em finite -.Fa v . -But programmers -might be surprised at first to discover that -.Fn hypot "\(+-\*(If" "\*(Na" -= +\*(If. -This is intentional; it happens because -.Fn hypot "\*(If" "v" -= +\*(If -for -.Em all -.Fa v , -finite or infinite. -Hence -.Fn hypot "\*(If" "v" -is independent of -.Fa v . -Unlike the reserved operand fault on a -.Tn VAX , -the -.Tn IEEE -\*(Na is designed to -disappear when it turns out to be irrelevant, as it does in -.Fn hypot "\*(If" "\*(Na" . -.Sh SEE ALSO -.Xr math 3 , -.Xr sqrt 3 -.Sh HISTORY -Both a -.Fn hypot -function and a -.Fn cabs -function -appeared in -.At v7 . diff --git a/libm/man/ieee.3 b/libm/man/ieee.3 deleted file mode 100644 index 3b7087d..0000000 --- a/libm/man/ieee.3 +++ /dev/null @@ -1,448 +0,0 @@ -.\" Copyright (c) 1985 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. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. 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: @(#)ieee.3 6.4 (Berkeley) 5/6/91 -.\" $FreeBSD: src/lib/msun/man/ieee.3,v 1.22 2005/06/16 21:55:45 ru Exp $ -.\" -.Dd January 26, 2005 -.Dt IEEE 3 -.Os -.Sh NAME -.Nm ieee -.Nd IEEE standard 754 for floating-point arithmetic -.Sh DESCRIPTION -The IEEE Standard 754 for Binary Floating-Point Arithmetic -defines representations of floating-point numbers and abstract -properties of arithmetic operations relating to precision, -rounding, and exceptional cases, as described below. -.Ss IEEE STANDARD 754 Floating-Point Arithmetic -Radix: Binary. -.Pp -Overflow and underflow: -.Bd -ragged -offset indent -compact -Overflow goes by default to a signed \*(If. -Underflow is -.Em gradual . -.Ed -.Pp -Zero is represented ambiguously as +0 or \-0. -.Bd -ragged -offset indent -compact -Its sign transforms correctly through multiplication or -division, and is preserved by addition of zeros -with like signs; but x\-x yields +0 for every -finite x. -The only operations that reveal zero's -sign are division by zero and -.Fn copysign x \(+-0 . -In particular, comparison (x > y, x \(>= y, etc.)\& -cannot be affected by the sign of zero; but if -finite x = y then \*(If = 1/(x\-y) \(!= \-1/(y\-x) = \-\*(If. -.Ed -.Pp -Infinity is signed. -.Bd -ragged -offset indent -compact -It persists when added to itself -or to any finite number. -Its sign transforms -correctly through multiplication and division, and -(finite)/\(+-\*(If\0=\0\(+-0 -(nonzero)/0 = \(+-\*(If. -But -\*(If\-\*(If, \*(If\(**0 and \*(If/\*(If -are, like 0/0 and sqrt(\-3), -invalid operations that produce \*(Na. ... -.Ed -.Pp -Reserved operands (\*(Nas): -.Bd -ragged -offset indent -compact -An \*(Na is -.Em ( N Ns ot Em a N Ns umber ) . -Some \*(Nas, called Signaling \*(Nas, trap any floating-point operation -performed upon them; they are used to mark missing -or uninitialized values, or nonexistent elements -of arrays. -The rest are Quiet \*(Nas; they are -the default results of Invalid Operations, and -propagate through subsequent arithmetic operations. -If x \(!= x then x is \*(Na; every other predicate -(x > y, x = y, x < y, ...) is FALSE if \*(Na is involved. -.Ed -.Pp -Rounding: -.Bd -ragged -offset indent -compact -Every algebraic operation (+, \-, \(**, /, -\(sr) -is rounded by default to within half an -.Em ulp , -and when the rounding error is exactly half an -.Em ulp -then -the rounded value's least significant bit is zero. -(An -.Em ulp -is one -.Em U Ns nit -in the -.Em L Ns ast -.Em P Ns lace . ) -This kind of rounding is usually the best kind, -sometimes provably so; for instance, for every -x = 1.0, 2.0, 3.0, 4.0, ..., 2.0**52, we find -(x/3.0)\(**3.0 == x and (x/10.0)\(**10.0 == x and ... -despite that both the quotients and the products -have been rounded. -Only rounding like IEEE 754 can do that. -But no single kind of rounding can be -proved best for every circumstance, so IEEE 754 -provides rounding towards zero or towards -+\*(If or towards \-\*(If -at the programmer's option. -.Ed -.Pp -Exceptions: -.Bd -ragged -offset indent -compact -IEEE 754 recognizes five kinds of floating-point exceptions, -listed below in declining order of probable importance. -.Bl -column -offset indent "Invalid Operation" "Gradual Underflow" -.Em "Exception Default Result" -Invalid Operation \*(Na, or FALSE -Overflow \(+-\*(If -Divide by Zero \(+-\*(If -Underflow Gradual Underflow -Inexact Rounded value -.El -.Pp -NOTE: An Exception is not an Error unless handled -badly. -What makes a class of exceptions exceptional -is that no single default response can be satisfactory -in every instance. -On the other hand, if a default -response will serve most instances satisfactorily, -the unsatisfactory instances cannot justify aborting -computation every time the exception occurs. -.Ed -.Ss Data Formats -Single-precision: -.Bd -ragged -offset indent -compact -Type name: -.Vt float -.Pp -Wordsize: 32 bits. -.Pp -Precision: 24 significant bits, -roughly like 7 significant decimals. -.Bd -ragged -offset indent -compact -If x and x' are consecutive positive single-precision -numbers (they differ by 1 -.Em ulp ) , -then -.Bd -ragged -compact -5.9e\-08 < 0.5**24 < (x'\-x)/x \(<= 0.5**23 < 1.2e\-07. -.Ed -.Ed -.Pp -.Bl -column "XXX" -compact -Range: Overflow threshold = 2.0**128 = 3.4e38 - Underflow threshold = 0.5**126 = 1.2e\-38 -.El -.Bd -ragged -offset indent -compact -Underflowed results round to the nearest -integer multiple of 0.5**149 = 1.4e\-45. -.Ed -.Ed -.Pp -Double-precision: -.Bd -ragged -offset indent -compact -Type name: -.Vt double -.Bd -ragged -offset indent -compact -On some architectures, -.Vt long double -is the the same as -.Vt double . -.Ed -.Pp -Wordsize: 64 bits. -.Pp -Precision: 53 significant bits, -roughly like 16 significant decimals. -.Bd -ragged -offset indent -compact -If x and x' are consecutive positive double-precision -numbers (they differ by 1 -.Em ulp ) , -then -.Bd -ragged -compact -1.1e\-16 < 0.5**53 < (x'\-x)/x \(<= 0.5**52 < 2.3e\-16. -.Ed -.Ed -.Pp -.Bl -column "XXX" -compact -Range: Overflow threshold = 2.0**1024 = 1.8e308 - Underflow threshold = 0.5**1022 = 2.2e\-308 -.El -.Bd -ragged -offset indent -compact -Underflowed results round to the nearest -integer multiple of 0.5**1074 = 4.9e\-324. -.Ed -.Ed -.Pp -Extended-precision: -.Bd -ragged -offset indent -compact -Type name: -.Vt long double -(when supported by the hardware) -.Pp -Wordsize: 96 bits. -.Pp -Precision: 64 significant bits, -roughly like 19 significant decimals. -.Bd -ragged -offset indent -compact -If x and x' are consecutive positive double-precision -numbers (they differ by 1 -.Em ulp ) , -then -.Bd -ragged -compact -1.0e\-19 < 0.5**63 < (x'\-x)/x \(<= 0.5**62 < 2.2e\-19. -.Ed -.Ed -.Pp -.Bl -column "XXX" -compact -Range: Overflow threshold = 2.0**16384 = 1.2e4932 - Underflow threshold = 0.5**16382 = 3.4e\-4932 -.El -.Bd -ragged -offset indent -compact -Underflowed results round to the nearest -integer multiple of 0.5**16445 = 5.7e\-4953. -.Ed -.Ed -.Pp -Quad-extended-precision: -.Bd -ragged -offset indent -compact -Type name: -.Vt long double -(when supported by the hardware) -.Pp -Wordsize: 128 bits. -.Pp -Precision: 113 significant bits, -roughly like 34 significant decimals. -.Bd -ragged -offset indent -compact -If x and x' are consecutive positive double-precision -numbers (they differ by 1 -.Em ulp ) , -then -.Bd -ragged -compact -9.6e\-35 < 0.5**113 < (x'\-x)/x \(<= 0.5**112 < 2.0e\-34. -.Ed -.Ed -.Pp -.Bl -column "XXX" -compact -Range: Overflow threshold = 2.0**16384 = 1.2e4932 - Underflow threshold = 0.5**16382 = 3.4e\-4932 -.El -.Bd -ragged -offset indent -compact -Underflowed results round to the nearest -integer multiple of 0.5**16494 = 6.5e\-4966. -.Ed -.Ed -.Ss Additional Information Regarding Exceptions -.Pp -For each kind of floating-point exception, IEEE 754 -provides a Flag that is raised each time its exception -is signaled, and stays raised until the program resets -it. -Programs may also test, save and restore a flag. -Thus, IEEE 754 provides three ways by which programs -may cope with exceptions for which the default result -might be unsatisfactory: -.Bl -enum -.It -Test for a condition that might cause an exception -later, and branch to avoid the exception. -.It -Test a flag to see whether an exception has occurred -since the program last reset its flag. -.It -Test a result to see whether it is a value that only -an exception could have produced. -.Pp -CAUTION: The only reliable ways to discover -whether Underflow has occurred are to test whether -products or quotients lie closer to zero than the -underflow threshold, or to test the Underflow -flag. -(Sums and differences cannot underflow in -IEEE 754; if x \(!= y then x\-y is correct to -full precision and certainly nonzero regardless of -how tiny it may be.) -Products and quotients that -underflow gradually can lose accuracy gradually -without vanishing, so comparing them with zero -(as one might on a VAX) will not reveal the loss. -Fortunately, if a gradually underflowed value is -destined to be added to something bigger than the -underflow threshold, as is almost always the case, -digits lost to gradual underflow will not be missed -because they would have been rounded off anyway. -So gradual underflows are usually -.Em provably -ignorable. -The same cannot be said of underflows flushed to 0. -.El -.Pp -At the option of an implementor conforming to IEEE 754, -other ways to cope with exceptions may be provided: -.Bl -enum -.It -ABORT. -This mechanism classifies an exception in -advance as an incident to be handled by means -traditionally associated with error-handling -statements like "ON ERROR GO TO ...". -Different -languages offer different forms of this statement, -but most share the following characteristics: -.Bl -dash -.It -No means is provided to substitute a value for -the offending operation's result and resume -computation from what may be the middle of an -expression. -An exceptional result is abandoned. -.It -In a subprogram that lacks an error-handling -statement, an exception causes the subprogram to -abort within whatever program called it, and so -on back up the chain of calling subprograms until -an error-handling statement is encountered or the -whole task is aborted and memory is dumped. -.El -.It -STOP. -This mechanism, requiring an interactive -debugging environment, is more for the programmer -than the program. -It classifies an exception in -advance as a symptom of a programmer's error; the -exception suspends execution as near as it can to -the offending operation so that the programmer can -look around to see how it happened. -Quite often -the first several exceptions turn out to be quite -unexceptionable, so the programmer ought ideally -to be able to resume execution after each one as if -execution had not been stopped. -.It -\&... Other ways lie beyond the scope of this document. -.El -.Pp -Ideally, each -elementary function should act as if it were indivisible, or -atomic, in the sense that ... -.Bl -enum -.It -No exception should be signaled that is not deserved by -the data supplied to that function. -.It -Any exception signaled should be identified with that -function rather than with one of its subroutines. -.It -The internal behavior of an atomic function should not -be disrupted when a calling program changes from -one to another of the five or so ways of handling -exceptions listed above, although the definition -of the function may be correlated intentionally -with exception handling. -.El -.Pp -The functions in -.Nm libm -are only approximately atomic. -They signal no inappropriate exception except possibly ... -.Bl -tag -width indent -offset indent -compact -.It Xo -Over/Underflow -.Xc -when a result, if properly computed, might have lain barely within range, and -.It Xo -Inexact in -.Fn cabs , -.Fn cbrt , -.Fn hypot , -.Fn log10 -and -.Fn pow -.Xc -when it happens to be exact, thanks to fortuitous cancellation of errors. -.El -Otherwise, ... -.Bl -tag -width indent -offset indent -compact -.It Xo -Invalid Operation is signaled only when -.Xc -any result but \*(Na would probably be misleading. -.It Xo -Overflow is signaled only when -.Xc -the exact result would be finite but beyond the overflow threshold. -.It Xo -Divide-by-Zero is signaled only when -.Xc -a function takes exactly infinite values at finite operands. -.It Xo -Underflow is signaled only when -.Xc -the exact result would be nonzero but tinier than the underflow threshold. -.It Xo -Inexact is signaled only when -.Xc -greater range or precision would be needed to represent the exact result. -.El -.Sh SEE ALSO -.Xr fenv 3 , -.Xr ieee_test 3 , -.Xr math 3 -.Pp -An explanation of IEEE 754 and its proposed extension p854 -was published in the IEEE magazine MICRO in August 1984 under -the title "A Proposed Radix- and Word-length-independent -Standard for Floating-point Arithmetic" by -.An "W. J. Cody" -et al. -The manuals for Pascal, C and BASIC on the Apple Macintosh -document the features of IEEE 754 pretty well. -Articles in the IEEE magazine COMPUTER vol.\& 14 no.\& 3 (Mar.\& -1981), and in the ACM SIGNUM Newsletter Special Issue of -Oct.\& 1979, may be helpful although they pertain to -superseded drafts of the standard. -.Sh STANDARDS -.St -ieee754 diff --git a/libm/man/ieee_test.3 b/libm/man/ieee_test.3 deleted file mode 100644 index debb6c8..0000000 --- a/libm/man/ieee_test.3 +++ /dev/null @@ -1,93 +0,0 @@ -.\" 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. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. 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: @(#)ieee.3 6.4 (Berkeley) 5/6/91 -.\" $FreeBSD: src/lib/msun/man/ieee_test.3,v 1.13 2005/11/17 13:00:00 ru Exp $ -.\" -.Dd November 6, 2005 -.Dt IEEE_TEST 3 -.Os -.Sh NAME -.Nm scalb , -.Nm scalbf , -.Nm significand , -.Nm significandf -.Nd IEEE test functions -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In math.h -.Ft double -.Fn scalb "double x" "double n" -.Ft float -.Fn scalbf "float x" "float n" -.Ft double -.Fn significand "double x" -.Ft float -.Fn significandf "float x" -.Sh DESCRIPTION -These functions allow users to test conformance to -.St -ieee754 . -Their use is not otherwise recommended. -.Pp -.Fn scalb x n -and -.Fn scalbf x n -return -.Fa x Ns \(**(2** Ns Fa n ) -computed by exponent manipulation. -If -.Fa n -is not an integer, \*(Pm\*(If, or an \*(Na, the result is unspecified. -.Pp -.Fn significand x -and -.Fn significandf x -return -.Fa sig , -where -.Fa x -:= -.Fa sig No \(** 2** Ns Fa n -with 1 \(<= -.Fa sig -< 2. -.Fn significand x -and -.Fn significandf x -are not defined when -.Fa x -is 0, \*(Pm\*(If, or \*(Na. -.Sh SEE ALSO -.Xr ieee 3 , -.Xr math 3 -.Sh STANDARDS -.St -ieee754 diff --git a/libm/man/ilogb.3 b/libm/man/ilogb.3 deleted file mode 100644 index 00ac754..0000000 --- a/libm/man/ilogb.3 +++ /dev/null @@ -1,127 +0,0 @@ -.\" 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. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. 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: @(#)ieee.3 6.4 (Berkeley) 5/6/91 -.\" $FreeBSD: src/lib/msun/man/ilogb.3,v 1.3 2005/11/17 13:00:00 ru Exp $ -.\" -.Dd November 6, 2005 -.Dt ILOGB 3 -.Os -.Sh NAME -.Nm ilogb , -.Nm ilogbf , -.Nm ilogbl , -.Nm logb , -.Nm logbf -.Nd extract exponent -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In math.h -.Ft int -.Fn ilogb "double x" -.Ft int -.Fn ilogbf "float x" -.Ft int -.Fn ilogbl "long double x" -.Ft double -.Fn logb "double x" -.Ft float -.Fn logbf "float x" -.Sh DESCRIPTION -.Fn ilogb , -.Fn ilogbf -and -.Fn ilogbl -return -.Fa x Ns 's exponent -in integer format. -.Fn ilogb \*(Pm\*(If -returns -.Dv INT_MAX , -.Fn ilogb \*(Pm\*(Na -returns -.Dv FP_ILOGBNAN , -and -.Fn ilogb 0 -returns -.Dv FP_ILOGB0 . -.Pp -.Fn logb x -and -.Fn logbf x -return -.Fa x Ns 's exponent -in floating\-point format with the same precision as -.Fa x . -.Fn logb \*(Pm\*(If -returns +\*(If, and -.Fn logb 0 -returns -\*(If with a division by zero exception. -.Sh SEE ALSO -.Xr frexp 3 , -.Xr ieee 3 , -.Xr math 3 , -.Xr scalbn 3 -.Sh STANDARDS -The -.Fn ilogb , -.Fn ilogbf , -.Fn ilogbl , -.Fn logb -and -.Fn logbf -routines conform to -.St -isoC-99 . -.Fn logb -and -.Fn logbf -implement the logb function recommended by -.St -ieee754 . -.Sh HISTORY -The -.Fn logb -function appeared in -.Bx 4.3 . -The -.Fn ilogb -function appeared in -.Fx 1.1.5 . -The -.Fn ilogbf -and -.Fn logbf -functions appeared in -.Fx 2.0 . -The -.Fn ilogbl -function appeared in -.Fx 5.4 . diff --git a/libm/man/j0.3 b/libm/man/j0.3 deleted file mode 100644 index 76cd51c..0000000 --- a/libm/man/j0.3 +++ /dev/null @@ -1,142 +0,0 @@ -.\" 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. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. 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: @(#)j0.3 6.7 (Berkeley) 4/19/91 -.\" $FreeBSD: src/lib/msun/man/j0.3,v 1.13 2005/01/14 23:28:28 das Exp $ -.\" -.Dd January 14, 2005 -.Dt J0 3 -.Os -.Sh NAME -.Nm j0 , -.Nm j0f , -.Nm j1 , -.Nm j1f , -.Nm jn , -.Nm jnf , -.Nm y0 , -.Nm y0f , -.Nm y1 , -.Nm y1f , -.Nm yn , -.Nm ynf -.Nd Bessel functions of first and second kind -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In math.h -.Ft double -.Fn j0 "double x" -.Ft float -.Fn j0f "float x" -.Ft double -.Fn j1 "double x" -.Ft float -.Fn j1f "float x" -.Ft double -.Fn jn "int n" "double x" -.Ft float -.Fn jnf "int n" "float x" -.Ft double -.Fn y0 "double x" -.Ft float -.Fn y0f "float x" -.Ft double -.Fn y1 "double x" -.Ft float -.Fn y1f "float x" -.Ft double -.Fn yn "int n" "double x" -.Ft float -.Fn ynf "int n" "float x" -.Sh DESCRIPTION -The functions -.Fn j0 , -.Fn j0f , -.Fn j1 -and -.Fn j1f -compute the -.Em Bessel function of the first kind of the order -0 and the -.Em order -1, respectively, -for the -real value -.Fa x ; -the functions -.Fn jn -and -.Fn jnf -compute the -.Em Bessel function of the first kind of the integer -.Em order -.Fa n -for the real value -.Fa x . -.Pp -The functions -.Fn y0 , -.Fn y0f , -.Fn y1 , -and -.Fn y1f -compute the linearly independent -.Em Bessel function of the second kind of the order -0 and the -.Em order -1, respectively, -for the -positive -.Em real -value -.Fa x ; -the functions -.Fn yn -and -.Fn ynf -compute the -.Em Bessel function of the second kind for the integer -.Em order -.Fa n -for the positive -.Em real -value -.Fa x . -.Sh RETURN VALUES -If these functions are successful, -the computed value is returned. -.Sh SEE ALSO -.Xr math 3 -.Sh HISTORY -This set of functions -appeared in -.At v7 . diff --git a/libm/man/lgamma.3 b/libm/man/lgamma.3 deleted file mode 100644 index 0064a48..0000000 --- a/libm/man/lgamma.3 +++ /dev/null @@ -1,185 +0,0 @@ -.\" 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. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. 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: @(#)lgamma.3 6.6 (Berkeley) 12/3/92 -.\" $FreeBSD: src/lib/msun/man/lgamma.3,v 1.22 2005/01/16 16:46:14 ru Exp $ -.\" -.Dd January 14, 2005 -.Dt LGAMMA 3 -.Os -.Sh NAME -.Nm lgamma , -.Nm lgamma_r , -.Nm lgammaf , -.Nm lgammaf_r , -.Nm gamma , -.Nm gamma_r , -.Nm gammaf , -.Nm gammaf_r , -.Nm tgamma -.Nd log gamma functions, gamma function -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In math.h -.Ft extern int -.Fa signgam ; -.sp -.Ft double -.Fn lgamma "double x" -.Ft double -.Fn lgamma_r "double x" "int *signgamp" -.Ft float -.Fn lgammaf "float x" -.Ft float -.Fn lgammaf_r "float x" "int *signgamp" -.Ft double -.Fn gamma "double x" -.Ft double -.Fn gamma_r "double x" "int *signgamp" -.Ft float -.Fn gammaf "float x" -.Ft float -.Fn gammaf_r "float x" "int *signgamp" -.Ft double -.Fn tgamma "double x" -.Sh DESCRIPTION -.Fn lgamma x -and -.Fn lgammaf x -.if t \{\ -return ln\||\(*G(x)| where -.Bd -unfilled -offset indent -\(*G(x) = \(is\d\s8\z0\s10\u\u\s8\(if\s10\d t\u\s8x\-1\s10\d e\u\s8\-t\s10\d dt for x > 0 and -\(*G(x) = \(*p/(\(*G(1\-x)\|sin(\(*px)) for x < 1. -.Ed -.\} -.if n \ -return ln\||\(*G(x)|. -.Pp -The external integer -.Fa signgam -returns the sign of \(*G(x). -.Pp -.Fn lgamma_r x signgamp -and -.Fn lgammaf_r x signgamp -provide the same functionality as -.Fn lgamma x -and -.Fn lgammaf x -but the caller must provide an integer to store the sign of \(*G(x). -.Pp -.Fn gamma , -.Fn gammaf , -.Fn gamma_r , -and -.Fn gammaf_r -are deprecated aliases for -.Fn lgamma , -.Fn lgammaf , -.Fn lgamma_r , -and -.Fn lgammaf_r , -respectively. -.Fn tgamma x -returns \(*G(x), with no effect on -.Fa signgam . -.Sh IDIOSYNCRASIES -Do not use the expression -.Dq Li signgam\(**exp(lgamma(x)) -to compute g := \(*G(x). -Instead use a program like this (in C): -.Bd -literal -offset indent -lg = lgamma(x); g = signgam\(**exp(lg); -.Ed -.Pp -Only after -.Fn lgamma -or -.Fn lgammaf -has returned can signgam be correct. -.Pp -For arguments in its range, -.Fn tgamma -is preferred, as for positive arguments -it is accurate to within one unit in the last place. -Exponentiation of -.Fn lgamma -will lose up to 10 significant bits. -.Sh RETURN VALUES -.Fn gamma , -.Fn gamma_r , -.Fn gammaf , -.Fn gammaf_r , -.Fn lgamma , -.Fn lgamma_r , -.Fn lgammaf , -and -.Fn lgammaf_r -return appropriate values unless an argument is out of range. -Overflow will occur for sufficiently large positive values, and -non-positive integers. -For large non-integer negative values, -.Fn tgamma -will underflow. -.Sh SEE ALSO -.Xr math 3 -.Sh STANDARDS -The -.Fn lgamma -and -.Fn tgamma -functions are expected to conform to -.St -isoC-99 . -.Sh HISTORY -The -.Fn lgamma -function appeared in -.Bx 4.3 . -The -.Fn gamma -function appeared in -.Bx 4.4 -as a function which computed \(*G(x). -This version was used in -.Fx 1.1 . -The name -.Fn gamma -was originally dedicated to the -.Fn lgamma -function, -and that usage was restored by switching to Sun's fdlibm in -.Fx 1.1.5 . -The -.Fn tgamma -function appeared in -.Fx 5.0 . diff --git a/libm/man/lrint.3 b/libm/man/lrint.3 deleted file mode 100644 index d7de093..0000000 --- a/libm/man/lrint.3 +++ /dev/null @@ -1,94 +0,0 @@ -.\" Copyright (c) 2005 David Schultz <das@FreeBSD.org> -.\" 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: src/lib/msun/man/lrint.3,v 1.2 2005/01/13 10:43:01 ru Exp $ -.\" -.Dd January 11, 2005 -.Dt LRINT 3 -.Os -.Sh NAME -.Nm llrint , -.Nm llrintf , -.Nm lrint , -.Nm lrintf -.Nd "convert to integer" -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In math.h -.Ft "long long" -.Fn llrint "double x" -.Ft "long long" -.Fn llrintf "float x" -.Ft long -.Fn lrint "double x" -.Ft long -.Fn lrintf "float x" -.Sh DESCRIPTION -The -.Fn lrint -function returns the integer nearest to its argument -.Fa x -according to the current rounding mode. -If the rounded result is too large to be represented as a -.Vt long -value, an invalid exception is raised and the return value is undefined. -Otherwise, if -.Fa x -is not an integer, -.Fn lrint -raises an inexact exception. -When the rounded result is representable as a -.Vt long , -the expression -.Fn lrint x -is equivalent to -.Po Vt long Pc Ns Fn rint x -(although the former may be more efficient). -.Pp -The -.Fn llrint , -.Fn llrintf , -and -.Fn lrintf -functions differ from -.Fn lrint -only in their input and output types. -.Sh SEE ALSO -.Xr lround 3 , -.Xr math 3 , -.Xr rint 3 , -.Xr round 3 -.Sh STANDARDS -The -.Fn llrint , -.Fn llrintf , -.Fn lrint , -and -.Fn lrintf -functions conform to -.St -isoC-99 . -.Sh HISTORY -These routines first appeared in -.Fx 5.4 . diff --git a/libm/man/lround.3 b/libm/man/lround.3 deleted file mode 100644 index d3e53c2..0000000 --- a/libm/man/lround.3 +++ /dev/null @@ -1,112 +0,0 @@ -.\" Copyright (c) 2005 David Schultz <das@FreeBSD.org> -.\" 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: src/lib/msun/man/lround.3,v 1.4 2005/06/15 19:04:04 ru Exp $ -.\" -.Dd April 7, 2005 -.Dt LROUND 3 -.Os -.Sh NAME -.Nm llround , -.Nm llroundf , -.Nm llroundl , -.Nm lround , -.Nm lroundf , -.Nm lroundl -.Nd "convert to nearest integral value" -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In math.h -.Ft "long long" -.Fn llround "double x" -.Ft "long long" -.Fn llroundf "float x" -.Ft "long long" -.Fn llroundl "long double x" -.Ft long -.Fn lround "double x" -.Ft long -.Fn lroundf "float x" -.Ft long -.Fn lroundl "long double x" -.Sh DESCRIPTION -The -.Fn lround -function returns the integer nearest to its argument -.Fa x , -rounding away from zero in halfway cases. -If the rounded result is too large to be represented as a -.Vt long -value, an invalid exception is raised and the return value is undefined. -Otherwise, if -.Fa x -is not an integer, -.Fn lround -may raise an inexact exception. -When the rounded result is representable as a -.Vt long , -the expression -.Fn lround x -is equivalent to -.Po Vt long Pc Ns Fn round x -(although the former may be more efficient). -.Pp -The -.Fn llround , -.Fn llroundf , -.Fn llroundl , -.Fn lroundf -and -.Fn lroundl -functions differ from -.Fn lround -only in their input and output types. -.Sh SEE ALSO -.Xr lrint 3 , -.Xr math 3 , -.Xr rint 3 , -.Xr round 3 -.Sh STANDARDS -The -.Fn llround , -.Fn llroundf , -.Fn llroundl , -.Fn lround , -.Fn lroundf , -and -.Fn lroundl -functions conform to -.St -isoC-99 . -.Sh HISTORY -The -.Vt float -and -.Vt double -versions of these routines first appeared in -.Fx 5.4 . -The -.Vt "long double" -versions appeared in -.Fx 6.0 . diff --git a/libm/man/math.3 b/libm/man/math.3 deleted file mode 100644 index 828b5e0..0000000 --- a/libm/man/math.3 +++ /dev/null @@ -1,242 +0,0 @@ -.\" Copyright (c) 1985 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. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. 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: @(#)math.3 6.10 (Berkeley) 5/6/91 -.\" $FreeBSD: src/lib/msun/man/math.3,v 1.27 2005/11/17 13:00:00 ru Exp $ -.\" -.Dd November 6, 2005 -.Dt MATH 3 -.Os -.if n \{\ -.char \[sr] "sqrt -.\} -.Sh NAME -.Nm math -.Nd "floating-point mathematical library" -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In math.h -.Sh DESCRIPTION -These functions constitute the C math library. -.Sh "LIST OF FUNCTIONS" -Each of the following -.Vt double -functions has a -.Vt float -counterpart with an -.Ql f -appended to the name and a -.Vt "long double" -counterpart with an -.Ql l -appended. -As an example, the -.Vt float -and -.Vt "long double" -counterparts of -.Ft double -.Fn acos "double x" -are -.Ft float -.Fn acosf "float x" -and -.Ft "long double" -.Fn acosl "long double x" , -respectively. -.de Cl -.Bl -column "isgreaterequal" "bessel function of the second kind of the order 0" -.Em "Name Description" -.. -.Ss Algebraic Functions -.Cl -cbrt cube root -fma fused multiply-add -hypot Euclidean distance -sqrt square root -.El -.Ss Classification Functions -.Cl -fpclassify classify a floating-point value -isfinite determine whether a value is finite -isinf determine whether a value is infinite -isnan determine whether a value is \*(Na -isnormal determine whether a value is normalized -.El -.Ss Exponent Manipulation Functions -.Cl -frexp extract exponent and mantissa -ilogb extract exponent -ldexp multiply by power of 2 -logb extract exponent -scalbln adjust exponent -scalbn adjust exponent -.El -.Ss Extremum- and Sign-Related Functions -.Cl -copysign copy sign bit -fabs absolute value -fdim positive difference -fmax maximum function -fmin minimum function -signbit extract sign bit -.El -.\" .Ss Not a Number -.\" .Cl -.\" nan return quiet \*(Na) 0 -.\" .El -.Ss Residue and Rounding Functions -.Cl -ceil integer no less than -floor integer no greater than -fmod positive remainder -llrint round to integer in fixed-point format -llround round to nearest integer in fixed-point format -lrint round to integer in fixed-point format -lround round to nearest integer in fixed-point format -modf extract integer and fractional parts -nearbyint round to integer (silent) -nextafter next representable value -nexttoward next representable value -remainder remainder -remquo remainder with partial quotient -rint round to integer -round round to nearest integer -trunc integer no greater in magnitude than -.El -.Pp -The -.Fn ceil , -.Fn floor , -.Fn llround , -.Fn lround , -.Fn round , -and -.Fn trunc -functions round in predetermined directions, whereas -.Fn llrint , -.Fn lrint , -and -.Fn rint -round according to the current (dynamic) rounding mode. -For more information on controlling the dynamic rounding mode, see -.Xr fenv 3 -and -.Xr fesetround 3 . -.Ss Silent Order Predicates -.Cl -isgreater greater than relation -isgreaterequal greater than or equal to relation -isless less than relation -islessequal less than or equal to relation -islessgreater less than or greater than relation -isunordered unordered relation -.El -.Ss Transcendental Functions -.Cl -acos inverse cosine -acosh inverse hyperbolic cosine -asin inverse sine -asinh inverse hyperbolic sine -atan inverse tangent -atanh inverse hyperbolic tangent -atan2 atan(y/x); complex argument -cos cosine -cosh hyperbolic cosine -erf error function -erfc complementary error function -exp exponential base e -exp2 exponential base 2 -expm1 exp(x)\-1 -j0 Bessel function of the first kind of the order 0 -j1 Bessel function of the first kind of the order 1 -jn Bessel function of the first kind of the order n -lgamma log gamma function -log natural logarithm -log10 logarithm to base 10 -log1p log(1+x) -.\" log2 base 2 logarithm -pow exponential x**y -sin trigonometric function -sinh hyperbolic function -tan trigonometric function -tanh hyperbolic function -tgamma gamma function -y0 Bessel function of the second kind of the order 0 -y1 Bessel function of the second kind of the order 1 -yn Bessel function of the second kind of the order n -.El -.Pp -Unlike the algebraic functions listed earlier, the routines -in this section may not produce a result that is correctly rounded, -so reproducible results cannot be guaranteed across platforms. -For most of these functions, however, incorrect rounding occurs -rarely, and then only in very-close-to-halfway cases. -.Sh SEE ALSO -.Xr fenv 3 , -.Xr ieee 3 -.Sh HISTORY -A math library with many of the present functions appeared in -.At v7 . -The library was substantially rewritten for -.Bx 4.3 -to provide -better accuracy and speed on machines supporting either VAX -or IEEE 754 floating-point. -Most of this library was replaced with FDLIBM, developed at Sun -Microsystems, in -.Fx 1.1.5 . -Additional routines, including ones for -.Vt float -and -.Vt long double -values, were written for or imported into subsequent versions of FreeBSD. -.Sh BUGS -The -.Fn log2 -and -.Fn nan -functions are missing, and many functions are not available in their -.Vt "long double" -variants. -.Pp -Many of the routines to compute transcendental functions produce -inaccurate results in other than the default rounding mode. -.Pp -On some architectures, trigonometric argument reduction is not -performed accurately, resulting in errors greater than 1 -.Em ulp -for large arguments to -.Fn cos , -.Fn sin , -and -.Fn tan . diff --git a/libm/man/nextafter.3 b/libm/man/nextafter.3 deleted file mode 100644 index 1c94fb7..0000000 --- a/libm/man/nextafter.3 +++ /dev/null @@ -1,100 +0,0 @@ -.\" 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. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. 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: @(#)ieee.3 6.4 (Berkeley) 5/6/91 -.\" $FreeBSD: src/lib/msun/man/nextafter.3,v 1.2 2005/03/07 05:00:29 das Exp $ -.\" -.Dd May 4, 2005 -.Dt NEXTAFTER 3 -.Os -.Sh NAME -.Nm nextafter , -.Nm nextafterf , -.Nm nextafterl , -.Nm nexttoward , -.Nm nexttowardf , -.Nm nexttowardl -.Nd next representable value -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In math.h -.Ft double -.Fn nextafter "double x" "double y" -.Ft float -.Fn nextafterf "float x" "float y" -.Ft long double -.Fn nextafterl "long double x" "long double y" -.Ft double -.Fn nexttoward "double x" "long double y" -.Ft float -.Fn nexttowardf "float x" "long double y" -.Ft long double -.Fn nexttowardl "long double x" "long double y" -.Sh DESCRIPTION -These functions -return the next machine representable number from -.Fa x -in direction -.Fa y . -.Sh SEE ALSO -.Xr ieee 3 , -.Xr math 3 -.Sh STANDARDS -The -.Fn nextafter , -.Fn nextafterf , -.Fn nextafterl , -.Fn nexttoward , -.Fn nexttowardf , -and -.Fn nexttowardl -routines conform to -.St -isoC-99 . -They implement the Nextafter function recommended by -.St -ieee754 , -with the extension that -.Fn nextafter +0.0, -0.0 -returns -.Li -0.0 , -and -.Fn nextafter -0.0, +0.0 -returns -.Li +0.0 . -.Sh HISTORY -The -.Fn nextafter -function appeared in -.Bx 4.3 , -and -.Fn nextafterf -appeared in -.Fx 2.0 . diff --git a/libm/man/remainder.3 b/libm/man/remainder.3 deleted file mode 100644 index 9b621e3..0000000 --- a/libm/man/remainder.3 +++ /dev/null @@ -1,146 +0,0 @@ -.\" 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. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. 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: @(#)ieee.3 6.4 (Berkeley) 5/6/91 -.\" $FreeBSD: src/lib/msun/man/remainder.3,v 1.4 2005/11/24 09:25:10 joel Exp $ -.\" -.Dd March 24, 2005 -.Dt REMAINDER 3 -.Os -.Sh NAME -.Nm remainder , -.Nm remainderf , -.Nm remquo , -.Nm remquof -.Nd minimal residue functions -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In math.h -.Ft double -.Fn remainder "double x" "double y" -.Ft float -.Fn remainderf "float x" "float y" -.Ft double -.Fn remquo "double x" "double y" "int *quo" -.Ft float -.Fn remquof "float x" "float y" "int *quo" -.Sh DESCRIPTION -.Fn remainder , -.Fn remainderf , -.Fn remquo , -and -.Fn remquof -return the remainder -.Fa r -:= -.Fa x -\- -.Fa n\(**y -where -.Fa n -is the integer nearest the exact value of -.Bk -words -.Fa x Ns / Ns Fa y ; -.Ek -moreover if -.Pf \\*(Ba Fa n -\- -.Sm off -.Fa x No / Fa y No \\*(Ba -.Sm on -= -1/2 -then -.Fa n -is even. -Consequently -the remainder is computed exactly and -.Sm off -.Pf \\*(Ba Fa r No \\*(Ba -.Sm on -\*(Le -.Sm off -.Pf \\*(Ba Fa y No \\*(Ba/2 . -.Sm on -But attempting to take the remainder when -.Fa y -is 0 or -.Fa x -is \*(Pm\*(If is an invalid operation that produces a \*(Na. -.Pp -The -.Fn remquo -and -.Fn remquof -functions also store the last -.Va k -bits of -.Fa n -in the location pointed to by -.Fa quo , -provided that -.Fa n -exists. -The number of bits -.Va k -is platform-specific, but is guaranteed to be at least 3. -.Sh SEE ALSO -.Xr fmod 3 , -.Xr ieee 3 , -.Xr math 3 -.Sh STANDARDS -The -.Fn remainder , -.Fn remainderf , -.Fn remquo , -and -.Fn remquof -routines conform to -.St -isoC-99 . -The remainder is as defined in -.St -ieee754 . -.Sh HISTORY -The -.Fn remainder -and -.Fn remainderf -functions appeared in -.Bx 4.3 -and -.Fx 2.0 , -respectively. -The -.Fn remquo -and -.Fn remquof -functions were added in -.Fx 6.0 . diff --git a/libm/man/rint.3 b/libm/man/rint.3 deleted file mode 100644 index ee55fea..0000000 --- a/libm/man/rint.3 +++ /dev/null @@ -1,103 +0,0 @@ -.\" 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. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. 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: @(#)rint.3 5.1 (Berkeley) 5/2/91 -.\" $FreeBSD: src/lib/msun/man/rint.3,v 1.11 2005/01/11 23:12:17 das Exp $ -.\" -.Dd July 5, 2004 -.Dt RINT 3 -.Os -.Sh NAME -.Nm nearbyint , -.Nm nearbyintf , -.Nm rint , -.Nm rintf -.Nd round to integral value in floating-point format -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In math.h -.Ft double -.Fn nearbyint "double x" -.Ft float -.Fn nearbyintf "float x" -.Ft double -.Fn rint "double x" -.Ft float -.Fn rintf "float x" -.Sh DESCRIPTION -The -.Fn rint -and the -.Fn rintf -functions return the integral value nearest to -.Fa x -according to the prevailing rounding mode. -These functions raise an inexact exception when the original argument -is not an exact integer. -.Pp -The -.Fn nearbyint -and -.Fn nearbyintf -functions perform the same operation, except that they do not raise -an inexact exception. -.Sh SEE ALSO -.Xr abs 3 , -.Xr ceil 3 , -.Xr fabs 3 , -.Xr fenv 3 , -.Xr floor 3 , -.Xr ieee 3 , -.Xr lrint 3 , -.Xr lround 3 , -.Xr math 3 , -.Xr round 3 -.Sh STANDARDS -The -.Fn nearbyint , -.Fn nearbyintf , -.Fn rint , -and -.Fn rintf -functions conform to -.St -isoC-99 . -.Sh HISTORY -A -.Fn rint -function appeared in -.At v6 . -The -.Fn nearbyint -and -.Fn nearbyintf -functions appeared in -.Fx 5.3 . diff --git a/libm/man/round.3 b/libm/man/round.3 deleted file mode 100644 index b077d77..0000000 --- a/libm/man/round.3 +++ /dev/null @@ -1,80 +0,0 @@ -.\" Copyright (c) 2003, Steven G. Kargl -.\" 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 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: src/lib/msun/man/round.3,v 1.6 2005/06/15 19:04:04 ru Exp $ -.\" -.Dd April 7, 2005 -.Dt ROUND 3 -.Os -.Sh NAME -.Nm round , -.Nm roundf , -.Nm roundl -.Nd round to nearest integral value -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In math.h -.Ft double -.Fn round "double x" -.Ft float -.Fn roundf "float x" -.Ft "long double" -.Fn roundl "long double x" -.Sh DESCRIPTION -The -.Fn round , -.Fn roundf , -and -.Fn roundl -functions return the nearest integral value to -.Fa x ; -if -.Fa x -lies halfway between two integral values, then these -functions return the integral value with the larger -absolute value (i.e., they round away from zero). -.Sh SEE ALSO -.Xr ceil 3 , -.Xr floor 3 , -.Xr ieee 3 , -.Xr lrint 3 , -.Xr lround 3 , -.Xr math 3 , -.Xr rint 3 , -.Xr trunc 3 -.Sh STANDARDS -These functions conform to -.St -isoC-99 . -.Sh HISTORY -The -.Fn round -and -.Fn roundf -functions appeared in -.Fx 5.3 . -The -.Fn roundl -function appeared in -.Fx 6.0 . diff --git a/libm/man/scalbn.3 b/libm/man/scalbn.3 deleted file mode 100644 index 923caab..0000000 --- a/libm/man/scalbn.3 +++ /dev/null @@ -1,95 +0,0 @@ -.\" 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. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. 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: @(#)ieee.3 6.4 (Berkeley) 5/6/91 -.\" $FreeBSD: src/lib/msun/man/scalbn.3,v 1.3 2005/11/24 09:25:10 joel Exp $ -.\" -.Dd March 4, 2005 -.Dt SCALBN 3 -.Os -.Sh NAME -.Nm scalbln , -.Nm scalblnf , -.Nm scalblnl , -.Nm scalbn , -.Nm scalbnf , -.Nm scalbnl -.Nd adjust exponent -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In math.h -.Ft double -.Fn scalbln "double x" "long n" -.Ft float -.Fn scalblnf "float x" "long n" -.Ft long double -.Fn scalblnl "long double x" "long n" -.Ft double -.Fn scalbn "double x" "int n" -.Ft float -.Fn scalbnf "float x" "int n" -.Ft long double -.Fn scalbnl "long double x" "int n" -.Sh DESCRIPTION -These routines return -.Fa x Ns \(**(2** Ns Fa n ) -computed by exponent manipulation. -.Sh SEE ALSO -.Xr ieee 3 , -.Xr math 3 -.Sh STANDARDS -These routines conform to -.St -isoC-99 , -and they implement the Scalb function recommended by -.St -ieee754 . -.Sh HISTORY -The -.Fn scalbn -and -.Fn scalbnf -functions appeared in -.Bx 4.3 -and -.Fx 2.0 , -respectively. -The -.Fn scalbln -and -.Fn scalblnf -functions first appeared in -.Fx 5.3 , -and -.Fn scalblnl -and -.Fn scalbln -in -.Fx 6.0 . diff --git a/libm/man/signbit.3 b/libm/man/signbit.3 deleted file mode 100644 index b749671..0000000 --- a/libm/man/signbit.3 +++ /dev/null @@ -1,57 +0,0 @@ -.\" Copyright (c) 2003 Mike Barcroft <mike@FreeBSD.org> -.\" 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: src/lib/msun/man/signbit.3,v 1.1 2004/07/19 08:16:10 das Exp $ -.\" -.Dd July 18, 2004 -.Dt SIGNBIT 3 -.Os -.Sh NAME -.Nm signbit -.Nd "determine whether a floating-point number's sign is negative" -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In math.h -.Ft int -.Fn signbit "real-floating x" -.Sh DESCRIPTION -The -.Fn signbit -macro takes an argument of -.Fa x -and returns non-zero if the value of its sign is negative, otherwise 0. -.Sh SEE ALSO -.Xr fpclassify 3 , -.Xr math 3 -.Sh STANDARDS -The -.Fn signbit -macro conforms to -.St -isoC-99 . -.Sh HISTORY -The -.Fn signbit -macro was added in -.Fx 5.1 . diff --git a/libm/man/sin.3 b/libm/man/sin.3 deleted file mode 100644 index 3a408a7..0000000 --- a/libm/man/sin.3 +++ /dev/null @@ -1,82 +0,0 @@ -.\" Copyright (c) 1991 The Regents of the University of California. -.\" All rights reserved. -.\" -.\" @(#)sin.3 6.7 (Berkeley) 4/19/91 -.\" 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. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. 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: @(#)sin.3 6.7 (Berkeley) 4/19/91 -.\" $FreeBSD: src/lib/msun/man/sin.3,v 1.9 2001/10/13 12:23:23 bde Exp $ -.\" -.Dd April 19, 1991 -.Dt SIN 3 -.Os -.Sh NAME -.Nm sin , -.Nm sinf -.Nd sine functions -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In math.h -.Ft double -.Fn sin "double x" -.Ft float -.Fn sinf "float x" -.Sh DESCRIPTION -The -.Fn sin -and the -.Fn sinf -functions compute the sine of -.Fa x -(measured in radians). -A large magnitude argument may yield a result with little -or no significance. -.Sh RETURN VALUES -The -.Fn sin -and the -.Fn sinf -functions return the sine value. -.Sh SEE ALSO -.Xr acos 3 , -.Xr asin 3 , -.Xr atan 3 , -.Xr atan2 3 , -.Xr cos 3 , -.Xr cosh 3 , -.Xr math 3 , -.Xr sinh 3 , -.Xr tan 3 , -.Xr tanh 3 -.Sh STANDARDS -The -.Fn sin -function conforms to -.St -isoC . diff --git a/libm/man/sinh.3 b/libm/man/sinh.3 deleted file mode 100644 index 8347862..0000000 --- a/libm/man/sinh.3 +++ /dev/null @@ -1,71 +0,0 @@ -.\" 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. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. 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: @(#)sinh.3 6.6 (Berkeley) 4/19/91 -.\" $FreeBSD: src/lib/msun/man/sinh.3,v 1.12 2005/01/14 23:28:28 das Exp $ -.Dd January 14, 2005 -.Dt SINH 3 -.Os -.Sh NAME -.Nm sinh , -.Nm sinhf -.Nd hyperbolic sine function -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In math.h -.Ft double -.Fn sinh "double x" -.Ft float -.Fn sinhf "float x" -.Sh DESCRIPTION -The -.Fn sinh -and the -.Fn sinhf -functions compute the hyperbolic sine of -.Fa x . -.Sh SEE ALSO -.Xr acos 3 , -.Xr asin 3 , -.Xr atan 3 , -.Xr atan2 3 , -.Xr cos 3 , -.Xr cosh 3 , -.Xr math 3 , -.Xr sin 3 , -.Xr tan 3 , -.Xr tanh 3 -.Sh STANDARDS -The -.Fn sinh -function conforms to -.St -isoC . diff --git a/libm/man/sqrt.3 b/libm/man/sqrt.3 deleted file mode 100644 index 22f8b7b..0000000 --- a/libm/man/sqrt.3 +++ /dev/null @@ -1,100 +0,0 @@ -.\" 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. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. 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: src/lib/msun/man/sqrt.3,v 1.12 2005/01/14 23:28:28 das Exp $ -.\" -.Dd May 6, 1991 -.Dt SQRT 3 -.Os -.Sh NAME -.Nm cbrt , -.Nm cbrtf , -.Nm sqrt , -.Nm sqrtf -.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 double -.Fn sqrt "double x" -.Ft float -.Fn sqrtf "float x" -.Sh DESCRIPTION -The -.Fn cbrt -and the -.Fn cbrtf -functions compute -the cube root of -.Ar x . -.Pp -The -.Fn sqrt -and the -.Fn sqrtf -functions compute the -non-negative square root of x. -.Sh RETURN VALUES -The -.Fn cbrt -and the -.Fn cbrtf -functions return the requested cube root. -The -.Fn sqrt -and the -.Fn sqrtf -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. -.Sh SEE ALSO -.Xr fenv 3 , -.Xr math 3 -.Sh STANDARDS -The -.Fn sqrt -function conforms to -.St -isoC . -.Sh HISTORY -The -.Fn cbrt -function appeared in -.Bx 4.3 . diff --git a/libm/man/tan.3 b/libm/man/tan.3 deleted file mode 100644 index 5995a3b..0000000 --- a/libm/man/tan.3 +++ /dev/null @@ -1,81 +0,0 @@ -.\" 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. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. 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: @(#)tan.3 5.1 (Berkeley) 5/2/91 -.\" $FreeBSD: src/lib/msun/man/tan.3,v 1.9 2001/10/13 12:23:23 bde Exp $ -.\" -.Dd May 2, 1991 -.Dt TAN 3 -.Os -.Sh NAME -.Nm tan , -.Nm tanf -.Nd tangent functions -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In math.h -.Ft double -.Fn tan "double x" -.Ft float -.Fn tanf "float x" -.Sh DESCRIPTION -The -.Fn tan -and the -.Fn tanf -functions compute the tangent of -.Fa x -(measured in radians). -A large magnitude argument may yield a result -with little or no significance. -For a discussion of error due to roundoff, see -.Xr math 3 . -.Sh RETURN VALUES -The -.Fn tan -function returns the tangent value. -.Sh SEE ALSO -.Xr acos 3 , -.Xr asin 3 , -.Xr atan 3 , -.Xr atan2 3 , -.Xr cos 3 , -.Xr cosh 3 , -.Xr math 3 , -.Xr sin 3 , -.Xr sinh 3 , -.Xr tanh 3 -.Sh STANDARDS -The -.Fn tan -function conforms to -.St -isoC . diff --git a/libm/man/tanh.3 b/libm/man/tanh.3 deleted file mode 100644 index 391bc15..0000000 --- a/libm/man/tanh.3 +++ /dev/null @@ -1,80 +0,0 @@ -.\" 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. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. 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: @(#)tanh.3 5.1 (Berkeley) 5/2/91 -.\" $FreeBSD: src/lib/msun/man/tanh.3,v 1.10 2001/10/13 12:23:23 bde Exp $ -.\" -.Dd May 2, 1991 -.Dt TANH 3 -.Os -.Sh NAME -.Nm tanh , -.Nm tanhf -.Nd hyperbolic tangent functions -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In math.h -.Ft double -.Fn tanh "double x" -.Ft float -.Fn tanhf "float x" -.Sh DESCRIPTION -The -.Fn tanh -and the -.Fn tanhf -functions compute the hyperbolic tangent of -.Fa x . -For a discussion of error due to roundoff, see -.Xr math 3 . -.Sh RETURN VALUES -The -.Fn tanh -and the -.Fn tanhf -functions return the hyperbolic tangent value. -.Sh SEE ALSO -.Xr acos 3 , -.Xr asin 3 , -.Xr atan 3 , -.Xr atan2 3 , -.Xr cos 3 , -.Xr cosh 3 , -.Xr math 3 , -.Xr sin 3 , -.Xr sinh 3 , -.Xr tan 3 -.Sh STANDARDS -The -.Fn tanh -function conforms to -.St -isoC . diff --git a/libm/man/trunc.3 b/libm/man/trunc.3 deleted file mode 100644 index cb6c26f..0000000 --- a/libm/man/trunc.3 +++ /dev/null @@ -1,80 +0,0 @@ -.\" Copyright (c) 2004, 2005 David Schultz <das@FreeBSD.org> -.\" 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: src/lib/msun/man/trunc.3,v 1.3 2005/06/15 19:04:04 ru Exp $ -.\" -.Dd April 16, 2005 -.Dt TRUNC 3 -.Os -.Sh NAME -.Nm trunc , -.Nm truncf , -.Nm truncl -.Nd nearest integral value with magnitude less than or equal to |x| -.Sh LIBRARY -.Lb libm -.Sh SYNOPSIS -.In math.h -.Ft double -.Fn trunc "double x" -.Ft float -.Fn truncf "float x" -.Ft "long double" -.Fn truncl "long double x" -.Sh DESCRIPTION -The -.Fn trunc , -.Fn truncf , -and -.Fn truncl -functions return the nearest integral value with magnitude less than -or equal to -.Pf | Fa x Ns | . -They are equivalent to -.Fn rint , -.Fn rintf , -and -.Fn rintl , -respectively, in the -.Dv FE_TOWARDZERO -rounding mode. -.Sh SEE ALSO -.Xr ceil 3 , -.Xr fesetround 3 , -.Xr floor 3 , -.Xr math 3 , -.Xr nextafter 3 , -.Xr rint 3 , -.Xr round 3 -.Sh STANDARDS -The -.Fn trunc , -.Fn truncf , -and -.Fn truncl -functions conform to -.St -isoC-99 . -.Sh HISTORY -These routines first appeared in -.Fx 5.3 . |