This is an automated email from the ASF dual-hosted git repository.

ggregory pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-lang.git


The following commit(s) were added to refs/heads/master by this push:
     new a064ec899 [LANG-1768] MutableLong and friends should provide better 
parsing exceptions Javadocs
     new 248ec2e71 Merge branch 'master' of 
https://garydgreg...@github.com/apache/commons-lang.git
a064ec899 is described below

commit a064ec899e88946d89c93b6ae66378f8e8cb3599
Author: Gary D. Gregory <garydgreg...@gmail.com>
AuthorDate: Mon Mar 24 08:28:10 2025 -0400

    [LANG-1768] MutableLong and friends should provide better parsing
    exceptions Javadocs
---
 src/changes/changes.xml                                           | 1 +
 src/main/java/org/apache/commons/lang3/mutable/MutableByte.java   | 2 +-
 src/main/java/org/apache/commons/lang3/mutable/MutableDouble.java | 2 +-
 src/main/java/org/apache/commons/lang3/mutable/MutableFloat.java  | 2 +-
 src/main/java/org/apache/commons/lang3/mutable/MutableInt.java    | 2 +-
 src/main/java/org/apache/commons/lang3/mutable/MutableLong.java   | 2 +-
 src/main/java/org/apache/commons/lang3/mutable/MutableShort.java  | 2 +-
 7 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/src/changes/changes.xml b/src/changes/changes.xml
index ac8c9e478..06bfd8802 100644
--- a/src/changes/changes.xml
+++ b/src/changes/changes.xml
@@ -83,6 +83,7 @@ The <action> type attribute can be add,update,fix,remove.
     <action                   type="fix" dev="ggregory" due-to="Gary 
Gregory">Instead of throwing a NullPointerException, 
ArrayUtils.toStringArray(Object[]) should return "null" for null elements like 
ArrayUtils.toStringArray(Object[], String) returns its 
valueForNullElements.</action>
     <action issue="LANG-1764" type="fix" dev="ggregory" due-to="Gary 
Gregory">Deprecate NumericEntityUnescaper.OPTION in favor of Apache Commons 
Text.</action>
     <action                   type="fix" dev="ggregory" due-to="Gary 
Gregory">Several hash collisions in Fraction class.</action>
+    <action issue="LANG-1768" type="fix" dev="ggregory" due-to="Wang Hailong, 
Gary Gregory">MutableLong and friends should provide better parsing exceptions 
Javadocs.</action>
     <!-- ADD -->
     <action                   type="add" dev="ggregory" due-to="Gary 
Gregory">Add Strings and refactor StringUtils.</action>
     <action issue="LANG-1747" type="add" dev="ggregory" due-to="Oliver B. 
Fischer, Gary Gregory">Add StopWatch.run([Failable]Runnable) and 
get([Failable]Supplier).</action>
diff --git a/src/main/java/org/apache/commons/lang3/mutable/MutableByte.java 
b/src/main/java/org/apache/commons/lang3/mutable/MutableByte.java
index 507adf4ba..f59c86cc7 100644
--- a/src/main/java/org/apache/commons/lang3/mutable/MutableByte.java
+++ b/src/main/java/org/apache/commons/lang3/mutable/MutableByte.java
@@ -68,7 +68,7 @@ public MutableByte(final Number value) {
      * Constructs a new MutableByte parsing the given string.
      *
      * @param value  the string to parse, not null
-     * @throws NumberFormatException if the string cannot be parsed into a byte
+     * @throws NumberFormatException if the string cannot be parsed into a 
byte, see {@link Byte#parseByte(String)}.
      * @since 2.5
      */
     public MutableByte(final String value) {
diff --git a/src/main/java/org/apache/commons/lang3/mutable/MutableDouble.java 
b/src/main/java/org/apache/commons/lang3/mutable/MutableDouble.java
index ab995c652..d8aaa79ed 100644
--- a/src/main/java/org/apache/commons/lang3/mutable/MutableDouble.java
+++ b/src/main/java/org/apache/commons/lang3/mutable/MutableDouble.java
@@ -66,7 +66,7 @@ public MutableDouble(final Number value) {
      * Constructs a new MutableDouble parsing the given string.
      *
      * @param value  the string to parse, not null
-     * @throws NumberFormatException if the string cannot be parsed into a 
double
+     * @throws NumberFormatException if the string cannot be parsed into a 
double, see {@link Double#parseDouble(String)}.
      * @since 2.5
      */
     public MutableDouble(final String value) {
diff --git a/src/main/java/org/apache/commons/lang3/mutable/MutableFloat.java 
b/src/main/java/org/apache/commons/lang3/mutable/MutableFloat.java
index b78294603..7b3e6890e 100644
--- a/src/main/java/org/apache/commons/lang3/mutable/MutableFloat.java
+++ b/src/main/java/org/apache/commons/lang3/mutable/MutableFloat.java
@@ -66,7 +66,7 @@ public MutableFloat(final Number value) {
      * Constructs a new MutableFloat parsing the given string.
      *
      * @param value  the string to parse, not null
-     * @throws NumberFormatException if the string cannot be parsed into a 
float
+     * @throws NumberFormatException if the string cannot be parsed into a 
float, see {@link Float#parseFloat(String)}.
      * @since 2.5
      */
     public MutableFloat(final String value) {
diff --git a/src/main/java/org/apache/commons/lang3/mutable/MutableInt.java 
b/src/main/java/org/apache/commons/lang3/mutable/MutableInt.java
index 03cac1b54..b407ba604 100644
--- a/src/main/java/org/apache/commons/lang3/mutable/MutableInt.java
+++ b/src/main/java/org/apache/commons/lang3/mutable/MutableInt.java
@@ -68,7 +68,7 @@ public MutableInt(final Number value) {
      * Constructs a new MutableInt parsing the given string.
      *
      * @param value  the string to parse, not null
-     * @throws NumberFormatException if the string cannot be parsed into an int
+     * @throws NumberFormatException if the string cannot be parsed into an 
int, see {@link Integer#parseInt(String)}.
      * @since 2.5
      */
     public MutableInt(final String value) {
diff --git a/src/main/java/org/apache/commons/lang3/mutable/MutableLong.java 
b/src/main/java/org/apache/commons/lang3/mutable/MutableLong.java
index cb60d4bc7..0b11e63f9 100644
--- a/src/main/java/org/apache/commons/lang3/mutable/MutableLong.java
+++ b/src/main/java/org/apache/commons/lang3/mutable/MutableLong.java
@@ -68,7 +68,7 @@ public MutableLong(final Number value) {
      * Constructs a new MutableLong parsing the given string.
      *
      * @param value  the string to parse, not null
-     * @throws NumberFormatException if the string cannot be parsed into a long
+     * @throws NumberFormatException if the string cannot be parsed into a 
long, see {@link Long#parseLong(String)}.
      * @since 2.5
      */
     public MutableLong(final String value) {
diff --git a/src/main/java/org/apache/commons/lang3/mutable/MutableShort.java 
b/src/main/java/org/apache/commons/lang3/mutable/MutableShort.java
index bee881589..3034b4c4a 100644
--- a/src/main/java/org/apache/commons/lang3/mutable/MutableShort.java
+++ b/src/main/java/org/apache/commons/lang3/mutable/MutableShort.java
@@ -68,7 +68,7 @@ public MutableShort(final short value) {
      * Constructs a new MutableShort parsing the given string.
      *
      * @param value  the string to parse, not null
-     * @throws NumberFormatException if the string cannot be parsed into a 
short
+     * @throws NumberFormatException if the string cannot be parsed into a 
short, see {@link Short#parseShort(String)}.
      * @since 2.5
      */
     public MutableShort(final String value) {

Reply via email to