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

joe darcy joe.darcy at oracle.com
Sun May 22 16:51:27 UTC 2016


Hello,

Some recently added math methods since "@since 1.9" rather than "@since 
9"; please review the patch below to use "@since 9" instead.

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