JDK 9 RFR Replace @since 1.9 with @since 9 on new math methods

Chris Hegarty chris.hegarty at oracle.com
Sun May 22 18:00:16 UTC 2016


> On 22 May 2016, at 17:51, joe darcy <joe.darcy at oracle.com> wrote:
> 
> Hello,
> 
> Some recently added math methods since "@since 1.9" rather than "@since 9"; please review the patch below to use "@since 9" instead.

Looks fine Joe.

-Chris.

> Thanks,
> 
> -Joe
> 
> diff -r 997dcff5075f src/java.base/share/classes/java/lang/Math.java
> --- a/src/java.base/share/classes/java/lang/Math.java    Sat May 21 13:18:15 2016 +0200
> +++ b/src/java.base/share/classes/java/lang/Math.java    Sun May 22 09:47:55 2016 -0700
> @@ -916,7 +916,7 @@
>      * @param y the second value
>      * @return the result
>      * @throws ArithmeticException if the result overflows a long
> -     * @since 1.9
> +     * @since 9
>      */
>     public static long multiplyExact(long x, int y) {
>         return multiplyExact(x, (long)y);
> @@ -1186,7 +1186,7 @@
>      * @throws ArithmeticException if the divisor {@code y} is zero
>      * @see #floorMod(long, int)
>      * @see #floor(double)
> -     * @since 1.9
> +     * @since 9
>      */
>     public static long floorDiv(long x, int y) {
>         return floorDiv(x, (long)y);
> @@ -1294,7 +1294,7 @@
>      * @return the floor modulus {@code x - (floorDiv(x, y) * y)}
>      * @throws ArithmeticException if the divisor {@code y} is zero
>      * @see #floorDiv(long, int)
> -     * @since 1.9
> +     * @since 9
>      */
>     public static int floorMod(long x, int y) {
>         // Result cannot overflow the range of int.
> diff -r 997dcff5075f src/java.base/share/classes/java/lang/StrictMath.java
> --- a/src/java.base/share/classes/java/lang/StrictMath.java    Sat May 21 13:18:15 2016 +0200
> +++ b/src/java.base/share/classes/java/lang/StrictMath.java    Sun May 22 09:47:55 2016 -0700
> @@ -811,7 +811,7 @@
>      * @return the result
>      * @throws ArithmeticException if the result overflows a long
>      * @see Math#multiplyExact(long,int)
> -     * @since 1.9
> +     * @since 9
>      */
>     public static long multiplyExact(long x, int y) {
>         return Math.multiplyExact(x, y);
> @@ -853,7 +853,7 @@
>      * @param y the second value
>      * @return the result
>      * @see Math#multiplyFull(int,int)
> -     * @since 1.9
> +     * @since 9
>      */
>     public static long multiplyFull(int x, int y) {
>         return Math.multiplyFull(x, y);
> @@ -867,7 +867,7 @@
>      * @param y the second value
>      * @return the result
>      * @see Math#multiplyHigh(long,long)
> -     * @since 1.9
> +     * @since 9
>      */
>     public static long multiplyHigh(long x, long y) {
>         return Math.multiplyHigh(x, y);
> @@ -915,7 +915,7 @@
>      * @throws ArithmeticException if the divisor {@code y} is zero
>      * @see Math#floorDiv(long, int)
>      * @see Math#floor(double)
> -     * @since 1.9
> +     * @since 9
>      */
>     public static long floorDiv(long x, int y) {
>         return Math.floorDiv(x, y);
> @@ -994,7 +994,7 @@
>      * @throws ArithmeticException if the divisor {@code y} is zero
>      * @see Math#floorMod(long, int)
>      * @see StrictMath#floorDiv(long, int)
> -     * @since 1.9
> +     * @since 9
>      */
>     public static int floorMod(long x, int y) {
>         return Math.floorMod(x , y);
> 




More information about the core-libs-dev mailing list