LANG-1189: Add getAndIncrement/getAndDecrement/getAndAdd/incrementAndGet/decrementAndGet/addAndGet in Mutable* classes

add since javadoc tags

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

@@ -124,6 +124,7 @@ public class MutableByte extends Number implements Comparable<MutableByte>, Muta
      * immediately prior to the increment operation. This method is not thread safe.
      *
      * @return the value associated with the instance before it was incremented
+     * @since 3.5
      */
     public byte getAndIncrement() {
         byte last = value;
@@ -136,6 +137,7 @@ public class MutableByte extends Number implements Comparable<MutableByte>, Muta
      * immediately after the increment operation. This method is not thread safe.
      *
      * @return the value associated with the instance after it is incremented
+     * @since 3.5
      */
     public byte incrementAndGet() {
         value++;
@@ -156,6 +158,7 @@ public class MutableByte extends Number implements Comparable<MutableByte>, Muta
      * immediately prior to the decrement operation. This method is not thread safe.
      *
      * @return the value associated with the instance before it was decremented
+     * @since 3.5
      */
     public byte getAndDecrement() {
         byte last = value;
@@ -168,6 +171,7 @@ public class MutableByte extends Number implements Comparable<MutableByte>, Muta
      * immediately after the decrement operation. This method is not thread safe.
      *
      * @return the value associated with the instance after it is decremented
+     * @since 3.5
      */
     public byte decrementAndGet() {
         value--;

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

@@ -141,6 +141,7 @@ public class MutableDouble extends Number implements Comparable<MutableDouble>,
      * immediately prior to the increment operation. This method is not thread safe.
      *
      * @return the value associated with the instance before it was incremented
+     * @since 3.5
      */
     public double getAndIncrement() {
         double last = value;
@@ -153,6 +154,7 @@ public class MutableDouble extends Number implements Comparable<MutableDouble>,
      * immediately after the increment operation. This method is not thread safe.
      *
      * @return the value associated with the instance after it is incremented
+     * @since 3.5
      */
     public double incrementAndGet() {
         value++;
@@ -173,6 +175,7 @@ public class MutableDouble extends Number implements Comparable<MutableDouble>,
      * immediately prior to the decrement operation. This method is not thread safe.
      *
      * @return the value associated with the instance before it was decremented
+     * @since 3.5
      */
     public double getAndDecrement() {
         double last = value;
@@ -185,6 +188,7 @@ public class MutableDouble extends Number implements Comparable<MutableDouble>,
      * immediately after the decrement operation. This method is not thread safe.
      *
      * @return the value associated with the instance after it is decremented
+     * @since 3.5
      */
     public double decrementAndGet() {
         value--;

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

@@ -141,6 +141,7 @@ public class MutableFloat extends Number implements Comparable<MutableFloat>, Mu
      * immediately prior to the increment operation. This method is not thread safe.
      *
      * @return the value associated with the instance before it was incremented
+     * @since 3.5
      */
     public float getAndIncrement() {
         float last = value;
@@ -153,6 +154,7 @@ public class MutableFloat extends Number implements Comparable<MutableFloat>, Mu
      * immediately after the increment operation. This method is not thread safe.
      *
      * @return the value associated with the instance after it is incremented
+     * @since 3.5
      */
     public float incrementAndGet() {
         value++;
@@ -173,6 +175,7 @@ public class MutableFloat extends Number implements Comparable<MutableFloat>, Mu
      * immediately prior to the decrement operation. This method is not thread safe.
      *
      * @return the value associated with the instance before it was decremented
+     * @since 3.5
      */
     public float getAndDecrement() {
         float last = value;
@@ -185,6 +188,7 @@ public class MutableFloat extends Number implements Comparable<MutableFloat>, Mu
      * immediately after the decrement operation. This method is not thread safe.
      *
      * @return the value associated with the instance after it is decremented
+     * @since 3.5
      */
     public float decrementAndGet() {
         value--;

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

@@ -124,6 +124,7 @@ public class MutableInt extends Number implements Comparable<MutableInt>, Mutabl
      * immediately prior to the increment operation. This method is not thread safe.
      *
      * @return the value associated with the instance before it was incremented
+     * @since 3.5
      */
     public int getAndIncrement() {
         int last = value;
@@ -136,6 +137,7 @@ public class MutableInt extends Number implements Comparable<MutableInt>, Mutabl
      * immediately after the increment operation. This method is not thread safe.
      *
      * @return the value associated with the instance after it is incremented
+     * @since 3.5
      */
     public int incrementAndGet() {
         value++;
@@ -156,6 +158,7 @@ public class MutableInt extends Number implements Comparable<MutableInt>, Mutabl
      * immediately prior to the decrement operation. This method is not thread safe.
      *
      * @return the value associated with the instance before it was decremented
+     * @since 3.5
      */
     public int getAndDecrement() {
         int last = value;
@@ -168,6 +171,7 @@ public class MutableInt extends Number implements Comparable<MutableInt>, Mutabl
      * immediately after the decrement operation. This method is not thread safe.
      *
      * @return the value associated with the instance after it is decremented
+     * @since 3.5
      */
     public int decrementAndGet() {
         value--;

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

@@ -124,6 +124,7 @@ public class MutableLong extends Number implements Comparable<MutableLong>, Muta
      * immediately prior to the increment operation. This method is not thread safe.
      *
      * @return the value associated with the instance before it was incremented
+     * @since 3.5
      */
     public long getAndIncrement() {
         long last = value;
@@ -136,6 +137,7 @@ public class MutableLong extends Number implements Comparable<MutableLong>, Muta
      * immediately after the increment operation. This method is not thread safe.
      *
      * @return the value associated with the instance after it is incremented
+     * @since 3.5
      */
     public long incrementAndGet() {
         value++;
@@ -156,6 +158,7 @@ public class MutableLong extends Number implements Comparable<MutableLong>, Muta
      * immediately prior to the decrement operation. This method is not thread safe.
      *
      * @return the value associated with the instance before it was decremented
+     * @since 3.5
      */
     public long getAndDecrement() {
         long last = value;
@@ -168,6 +171,7 @@ public class MutableLong extends Number implements Comparable<MutableLong>, Muta
      * immediately after the decrement operation. This method is not thread safe.
      *
      * @return the value associated with the instance after it is decremented
+     * @since 3.5
      */
     public long decrementAndGet() {
         value--;

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

@@ -124,6 +124,7 @@ public class MutableShort extends Number implements Comparable<MutableShort>, Mu
      * immediately prior to the increment operation. This method is not thread safe.
      *
      * @return the value associated with the instance before it was incremented
+     * @since 3.5
      */
     public short getAndIncrement() {
         short last = value;
@@ -136,6 +137,7 @@ public class MutableShort extends Number implements Comparable<MutableShort>, Mu
      * immediately after the increment operation. This method is not thread safe.
      *
      * @return the value associated with the instance after it is incremented
+     * @since 3.5
      */
     public short incrementAndGet() {
         value++;
@@ -156,6 +158,7 @@ public class MutableShort extends Number implements Comparable<MutableShort>, Mu
      * immediately prior to the decrement operation. This method is not thread safe.
      *
      * @return the value associated with the instance before it was decremented
+     * @since 3.5
      */
     public short getAndDecrement() {
         short last = value;
@@ -168,6 +171,7 @@ public class MutableShort extends Number implements Comparable<MutableShort>, Mu
      * immediately after the decrement operation. This method is not thread safe.
      *
      * @return the value associated with the instance after it is decremented
+     * @since 3.5
      */
     public short decrementAndGet() {
         value--;