added new function mpfr_cosu

git-svn-id: https://scm.gforge.inria.fr/anonscm/svn/mpfr/trunk@14199 280ebfd0-de03-0410-8827-d642c229c3f4

1 files changed, 15 insertions, 5 deletions

diff --git a/doc/mpfr.texi b/doc/mpfr.texi
index 0402ac537..afe2a25f9 100644
--- a/doc/mpfr.texi
+++ b/doc/mpfr.texi
@@ -2267,15 +2267,23 @@ Set @var{rop} to the cosine of @var{op}, sine of @var{op},
 tangent of @var{op}, rounded in the direction @var{rnd}.
 @end deftypefun
 
-@deftypefun int mpfr_sinu (mpfr_t @var{rop}, mpfr_t @var{op}, unsigned long @var{u}, mpfr_rnd_t @var{rnd})
-Set @var{rop} to the sine of @m{@var{op} \times 2\pi/u,@var{op} multiplied
-by 2@tie{}Pi and divided by @var{u}}. Thus for @var{u} equal to 360, one
-gets the sine for @var{op} in degrees. When @m{@var{op} \times 2/u,@var{op}
+@deftypefun int mpfr_cosu (mpfr_t @var{rop}, mpfr_t @var{op}, unsigned long @var{u}, mpfr_rnd_t @var{rnd})
+@deftypefunx int mpfr_sinu (mpfr_t @var{rop}, mpfr_t @var{op}, unsigned long @var{u}, mpfr_rnd_t @var{rnd})
+Set @var{rop} to the cosine (resp. sine) of @m{@var{op} \times 2\pi/u,@var{op} multiplied
+by 2@tie{}Pi and divided by @var{u}}. Thus if @var{u} equals 360, one
+gets the cosine (resp. sine) for @var{op} in degrees.
+For @code{mpfr_cosu},
+when @m{@var{op} \times 2/u,@var{op}
+multiplied by 2 and divided by @var{u}} is a half-integer, the result is +0,
+following IEEE@tie{}754-2019 (cosPi),
+so that the function is even.
+For @code{mpfr_sinu},
+when @m{@var{op} \times 2/u,@var{op}
 multiplied by 2 and divided by @var{u}} is an integer, the result is zero
 with the same sign as @var{op}, following IEEE@tie{}754-2019 (sinPi),
 so that the function is odd.
 
-Note: this function is experimental and its interface might change in future
+Note: these functions are experimental and their interface might change in future
 versions.
 @end deftypefun
 
@@ -4114,6 +4122,8 @@ but not documented,
 and with a slight difference in the semantics (when
 the second input operand is a NaN)@.
 
+@item @code{mpfr_cosu} in MPFR@tie{}4.2.0 (experimental).
+
 @item @code{mpfr_custom_get_significand} in MPFR@tie{}3.0.
 This function was named @code{mpfr_custom_get_mantissa} in previous
 versions; @code{mpfr_custom_get_mantissa} is still available via a