OpenJDK / jdk / jdk
changeset 56072:cf45b7945e4b
8229337: java.lang.Math class doc should be adjusted regarding -Exact methods
Reviewed-by: rriggs, bpb
Contributed-by: Julia Boes <julia.boes@oracle.com>
| author | dfuchs |
|---|---|
| date | Fri, 23 Aug 2019 18:40:59 +0100 |
| parents | 00bf1e66de11 |
| children | c370cc1b2a86 |
| files | src/java.base/share/classes/java/lang/Math.java |
| diffstat | 1 files changed, 7 insertions(+), 7 deletions(-) [+] |
line wrap: on
line diff
--- a/src/java.base/share/classes/java/lang/Math.java Fri Aug 23 03:06:24 2019 -0700 +++ b/src/java.base/share/classes/java/lang/Math.java Fri Aug 23 18:40:59 2019 +0100 @@ -1,5 +1,5 @@ /* - * Copyright (c) 1994, 2017, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1994, 2019, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -92,12 +92,12 @@ * The best practice is to choose the primitive type and algorithm to avoid * overflow. In cases where the size is {@code int} or {@code long} and * overflow errors need to be detected, the methods {@code addExact}, - * {@code subtractExact}, {@code multiplyExact}, and {@code toIntExact} + * {@code subtractExact}, {@code multiplyExact}, {@code toIntExact}, + * {@code incrementExact}, {@code decrementExact} and {@code negateExact} * throw an {@code ArithmeticException} when the results overflow. - * For other arithmetic operations such as divide, absolute value, - * increment by one, decrement by one, and negation, overflow occurs only with - * a specific minimum or maximum value and should be checked against - * the minimum or maximum as appropriate. + * For the arithmetic operations divide and absolute value, overflow + * occurs only with a specific minimum or maximum value and + * should be checked against the minimum or maximum as appropriate. * * @author unascribed * @author Joseph D. Darcy @@ -1058,7 +1058,7 @@ } /** - * Returns the value of the {@code long} argument; + * Returns the value of the {@code long} argument, * throwing an exception if the value overflows an {@code int}. * * @param value the long value