[src/trunk]: src/lib/libm Split out pow(3) from exp(3).

[jruoho <jruoho%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/5aad4e6a70f9
branches:  trunk
changeset: 769660:5aad4e6a70f9
user:      jruoho <jruoho%NetBSD.org@localhost>
date:      Sat Sep 17 10:51:52 2011 +0000

description:
Split out pow(3) from exp(3).

diffstat:

 lib/libm/Makefile  |   8 ++--
 lib/libm/man/pow.3 |  80 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 84 insertions(+), 4 deletions(-)

diffs (120 lines):

diff -r 421754b701f9 -r 5aad4e6a70f9 lib/libm/Makefile
--- a/lib/libm/Makefile Sat Sep 17 10:46:52 2011 +0000
+++ b/lib/libm/Makefile Sat Sep 17 10:51:52 2011 +0000
@@ -1,4 +1,4 @@
-#  $NetBSD: Makefile,v 1.119 2011/09/13 05:26:47 jruoho Exp $
+#  $NetBSD: Makefile,v 1.120 2011/09/17 10:51:52 jruoho Exp $
 #
 #  @(#)Makefile 5.1beta 93/09/24
 #
@@ -211,7 +211,7 @@
        erf.3 exp.3 \
        fabs.3 finite.3 fmod.3 frexp.3 hypot.3 \
        ieee_test.3 ilogb.3 isinff.3 j0.3 ldexp.3 lgamma.3 log.3 lrint.3 \
-       math.3 modf.3 nextafter.3 \
+       math.3 modf.3 nextafter.3 pow.3 \
        remainder.3 rint.3 round.3 \
        scalbn.3 sin.3 sinh.3 sqrt.3 \
        tan.3 tanh.3 trunc.3 fmax.3 fdim.3
@@ -245,8 +245,7 @@
 MLINKS+=cosh.3 coshf.3
 MLINKS+=erf.3 erff.3 erf.3 erfc.3 erf.3 erfcf.3
 MLINKS+=exp.3 expf.3 exp.3 expm1.3 exp.3 expm1f.3                      \
-       exp.3 exp2.3 exp.3 exp2f.3                                      \
-       exp.3 pow.3 exp.3 powf.3
+       exp.3 exp2.3 exp.3 exp2f.3
 MLINKS+=log.3 logf.3 \
        log.3 log10.3 \
        log.3 log10f.3 \
@@ -254,6 +253,7 @@
        log.3 log1pf.3 \
        log.3 log2.3 \
        log.3 log2f.3
+MLINKS+=pow.3 powf.3
 MLINKS+=fabs.3 fabsf.3
 MLINKS+=finite.3 finitef.3
 MLINKS+=fmod.3 fmodf.3
diff -r 421754b701f9 -r 5aad4e6a70f9 lib/libm/man/pow.3
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/lib/libm/man/pow.3        Sat Sep 17 10:51:52 2011 +0000
@@ -0,0 +1,80 @@
+.\" $NetBSD: pow.3,v 1.1 2011/09/17 10:51:53 jruoho Exp $
+.\"
+.\" Copyright (c) 2011 Jukka Ruohonen <jruohonen%iki.fi@localhost>
+.\" 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 NETBSD FOUNDATION, INC. 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 FOUNDATION 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.
+.\"
+.Dd September 13, 2011
+.Dt POW 3
+.Os
+.Sh NAME
+.Nm pow ,
+.Nm powf
+.Nd power functions
+.Sh LIBRARY
+.Lb libm
+.Sh SYNOPSIS
+.In math.h
+.Ft double
+.Fn pow "double x" "double y"
+.Ft float
+.Fn powf "float x" "float y"
+.Sh DESCRIPTION
+The
+.Fn pow
+family of functions return
+.Fa x
+raised to the power of
+.Fa y .
+.Pp
+If
+.Fa x
+is negative and
+.Fa y
+is not an integer, the global variable
+.Va errno
+is set to
+.Er EDOM ,
+and on
+.Tn VAX
+a reserved operand fault is generated.
+A portable application should nevertheless ensure that
+.Fa y
+is an integer value whenever
+.Fa x
+is negative.
+.Sh RETURN VALUES
+.\"
+.\" XXX: List also the special return values?
+.\"
+Upon successful completion, the described functions return
+.Fa x^y .
+.Sh SEE ALSO
+.Xr exp 3 ,
+.Xr log 3
+.Sh STANDARDS
+The described functions conform to
+.St -isoC-99 .
+.Sh HISTORY
+The history of the power functions dates back to
+.At v6 .