Javadoc

Author: garydgregory

src/main/java/org/apache/commons/lang3/mutable/MutableBoolean.java

@@ -18,16 +18,21 @@
 package org.apache.commons.lang3.mutable;
 
 import java.io.Serializable;
+import java.util.concurrent.atomic.AtomicBoolean;
 
 import org.apache.commons.lang3.BooleanUtils;
 
 /**
  * A mutable {@code boolean} wrapper.
  * <p>
- * Note that as MutableBoolean does not extend Boolean, it is not treated by String.format as a Boolean parameter.
+ * This class was created before the introduction of {@link AtomicBoolean}.
+ * </p>
+ * <p>
+ * Note that as MutableBoolean does not extend {@link Boolean}, it is not treated by {@link String#format(String, Object...)} as a Boolean parameter.
  * </p>
  *
  * @see Boolean
+ * @see AtomicBoolean
  * @since 2.2
  */
 public class MutableBoolean implements Mutable<Boolean>, Serializable, Comparable<MutableBoolean> {

src/main/java/org/apache/commons/lang3/mutable/MutableInt.java

@@ -16,15 +16,21 @@
  */
 package org.apache.commons.lang3.mutable;
 
+import java.util.concurrent.atomic.AtomicInteger;
+
 import org.apache.commons.lang3.math.NumberUtils;
 
 /**
  * A mutable {@code int} wrapper.
  * <p>
- * Note that as MutableInt does not extend Integer, it is not treated by String.format as an Integer parameter.
+ * This class was created before the introduction of {@link AtomicInteger}.
+ * </p>
+ * <p>
+ * Note that as MutableInt does not extend {@link Integer}, it is not treated by {@link String#format(String, Object...)} as an Integer parameter.
  * </p>
  *
  * @see Integer
+ * @see AtomicInteger
  * @since 2.1
  */
 public class MutableInt extends Number implements Comparable<MutableInt>, Mutable<Number> {

src/main/java/org/apache/commons/lang3/mutable/MutableLong.java

@@ -16,15 +16,21 @@
  */
 package org.apache.commons.lang3.mutable;
 
+import java.util.concurrent.atomic.AtomicLong;
+
 import org.apache.commons.lang3.math.NumberUtils;
 
 /**
  * A mutable {@code long} wrapper.
  * <p>
- * Note that as MutableLong does not extend Long, it is not treated by String.format as a Long parameter.
+ * This class was created before the introduction of {@link AtomicLong}.
+ * </p>
+ * <p>
+ * Note that as MutableLong does not extend {@link Long}, it is not treated by {@link String#format(String, Object...)} as a Long parameter.
  * </p>
  *
  * @see Long
+ * @see AtomicLong
  * @since 2.1
  */
 public class MutableLong extends Number implements Comparable<MutableLong>, Mutable<Number> {

src/main/java/org/apache/commons/lang3/mutable/MutableObject.java

@@ -19,11 +19,16 @@
 
 import java.io.Serializable;
 import java.util.Objects;
+import java.util.concurrent.atomic.AtomicReference;
 
 /**
  * A mutable {@link Object} wrapper.
+ * <p>
+ * This class was created before the introduction of {@link AtomicReference}.
+ * </p>
  *
- * @param <T> the type to set and get
+ * @param <T> the type to set and get.
+ * @see AtomicReference
  * @since 2.1
  */
 public class MutableObject<T> implements Mutable<T>, Serializable {