Add version numbers to all @since tags

Specifically, for every @since tag with a date, I added another that
contains the correspending version.  I did not add date @since tags to
comments that do not have them, as that would be too tedious for what
it's worth.  These dates could still be found by using git bisect
though.

1 files changed, 23 insertions, 0 deletions

diff --git a/src/main/java/sevenUnits/unit/LinearUnitValue.java b/src/main/java/sevenUnits/unit/LinearUnitValue.java
index 8d30907..86520d7 100644
--- a/src/main/java/sevenUnits/unit/LinearUnitValue.java
+++ b/src/main/java/sevenUnits/unit/LinearUnitValue.java
@@ -34,6 +34,7 @@ import sevenUnits.utils.UncertainDouble;
  * 
  * @author Adrien Hopkins
  * @since 2020-07-26
+ * @since v0.3.0
  */
 public final class LinearUnitValue {
 	/** The value 1 as a LinearUnitValue. */
@@ -46,6 +47,7 @@ public final class LinearUnitValue {
 	 * @param value value to express
 	 * @return exact {@code LinearUnitValue} instance
 	 * @since 2020-07-26
+	 * @since v0.3.0
 	 */
 	public static final LinearUnitValue getExact(final LinearUnit unit,
 			final double value) {
@@ -61,6 +63,7 @@ public final class LinearUnitValue {
 	 * @param value value to express
 	 * @return uncertain {@code LinearUnitValue} instance
 	 * @since 2020-07-26
+	 * @since v0.3.0
 	 */
 	public static final LinearUnitValue of(final LinearUnit unit,
 			final UncertainDouble value) {
@@ -77,6 +80,7 @@ public final class LinearUnitValue {
 	 * @param unit  unit to express as
 	 * @param value value to express
 	 * @since 2020-07-26
+	 * @since v0.3.0
 	 */
 	private LinearUnitValue(final LinearUnit unit, final UncertainDouble value) {
 		this.unit = unit;
@@ -87,6 +91,7 @@ public final class LinearUnitValue {
 	 * @return this value as a {@code UnitValue}. All uncertainty information is
 	 *         removed from the returned value.
 	 * @since 2020-08-04
+	 * @since v0.3.0
 	 */
 	public final UnitValue asUnitValue() {
 		return UnitValue.of(this.unit, this.value.value());
@@ -96,6 +101,7 @@ public final class LinearUnitValue {
 	 * @param other a {@code LinearUnit}
 	 * @return true iff this value can be represented with {@code other}.
 	 * @since 2020-07-26
+	 * @since v0.3.0
 	 */
 	public final boolean canConvertTo(final LinearUnit other) {
 		return this.unit.canConvertTo(other);
@@ -108,6 +114,7 @@ public final class LinearUnitValue {
 	 * @param other new unit to express value in
 	 * @return value expressed in {@code other}
 	 * @since 2020-07-26
+	 * @since v0.3.0
 	 */
 	public final LinearUnitValue convertTo(final LinearUnit other) {
 		return LinearUnitValue.of(other, this.unit.convertTo(other, this.value));
@@ -122,6 +129,7 @@ public final class LinearUnitValue {
 	 * @throws IllegalArgumentException if no units are provided or units
 	 *                                  provided have incompatible bases
 	 * @since 2024-08-15
+	 * @since v1.0.0
 	 */
 	public final List<LinearUnitValue> convertToMultiple(
 			final List<LinearUnit> others) {
@@ -155,6 +163,7 @@ public final class LinearUnitValue {
 	 * @param divisor value to divide by
 	 * @return multiplied value
 	 * @since 2020-07-28
+	 * @since v0.3.0
 	 */
 	public LinearUnitValue dividedBy(final double divisor) {
 		return LinearUnitValue.of(this.unit, this.value.dividedByExact(divisor));
@@ -166,6 +175,7 @@ public final class LinearUnitValue {
 	 * @param divisor value to multiply by
 	 * @return quotient
 	 * @since 2020-07-28
+	 * @since v0.3.0
 	 */
 	public LinearUnitValue dividedBy(final LinearUnitValue divisor) {
 		return LinearUnitValue.of(this.unit.dividedBy(divisor.unit),
@@ -178,6 +188,7 @@ public final class LinearUnitValue {
 	 * km) returns true.
 	 * 
 	 * @since 2020-07-26
+	 * @since v0.3.0
 	 * @see #equals(Object, boolean)
 	 */
 	@Override
@@ -202,6 +213,7 @@ public final class LinearUnitValue {
 	 * @return true iff this and obj are equal
 	 * 
 	 * @since 2020-07-28
+	 * @since v0.3.0
 	 */
 	public boolean equals(final Object obj, final boolean avoidFPErrors) {
 		if (!avoidFPErrors)
@@ -219,6 +231,7 @@ public final class LinearUnitValue {
 	 * @return true iff this and other are within each other's uncertainty range
 	 * 
 	 * @since 2020-07-26
+	 * @since v0.3.0
 	 */
 	public boolean equivalent(final LinearUnitValue other) {
 		if (other == null
@@ -234,6 +247,7 @@ public final class LinearUnitValue {
 	/**
 	 * @return the unit
 	 * @since 2020-09-29
+	 * @since v0.3.0
 	 */
 	public final LinearUnit getUnit() {
 		return this.unit;
@@ -242,6 +256,7 @@ public final class LinearUnitValue {
 	/**
 	 * @return the value
 	 * @since 2020-09-29
+	 * @since v0.3.0
 	 */
 	public final UncertainDouble getValue() {
 		return this.value;
@@ -250,6 +265,7 @@ public final class LinearUnitValue {
 	/**
 	 * @return the exact value
 	 * @since 2020-09-07
+	 * @since v0.3.0
 	 */
 	public final double getValueExact() {
 		return this.value.value();
@@ -270,6 +286,7 @@ public final class LinearUnitValue {
 	 * @throws IllegalArgumentException if {@code subtrahend} has a unit that is
 	 *                                  not compatible for addition
 	 * @since 2020-07-26
+	 * @since v0.3.0
 	 */
 	public LinearUnitValue minus(final LinearUnitValue subtrahend) {
 		Objects.requireNonNull(subtrahend, "subtrahend may not be null");
@@ -292,6 +309,7 @@ public final class LinearUnitValue {
 	 * @throws IllegalArgumentException if {@code addend} has a unit that is not
 	 *                                  compatible for addition
 	 * @since 2020-07-26
+	 * @since v0.3.0
 	 */
 	public LinearUnitValue plus(final LinearUnitValue addend) {
 		Objects.requireNonNull(addend, "addend may not be null");
@@ -312,6 +330,7 @@ public final class LinearUnitValue {
 	 * @param multiplier value to multiply by
 	 * @return multiplied value
 	 * @since 2020-07-28
+	 * @since v0.3.0
 	 */
 	public LinearUnitValue times(final double multiplier) {
 		return LinearUnitValue.of(this.unit, this.value.timesExact(multiplier));
@@ -323,6 +342,7 @@ public final class LinearUnitValue {
 	 * @param multiplier value to multiply by
 	 * @return product
 	 * @since 2020-07-28
+	 * @since v0.3.0
 	 */
 	public LinearUnitValue times(final LinearUnitValue multiplier) {
 		return LinearUnitValue.of(this.unit.times(multiplier.unit),
@@ -335,6 +355,7 @@ public final class LinearUnitValue {
 	 * @param exponent exponent to raise to
 	 * @return result of exponentiation
 	 * @since 2020-07-28
+	 * @since v0.3.0
 	 */
 	public LinearUnitValue toExponent(final int exponent) {
 		return LinearUnitValue.of(this.unit.toExponent(exponent),
@@ -348,6 +369,7 @@ public final class LinearUnitValue {
 	 * @return result of exponentation
 	 *
 	 * @since 2024-08-22
+	 * @since v1.0.0
 	 * @see ObjectProduct#toExponentRounded
 	 */
 	public LinearUnitValue toExponentRounded(final double exponent) {
@@ -375,6 +397,7 @@ public final class LinearUnitValue {
 	 * @return string representing this value
 	 * 
 	 * @since 2020-07-26
+	 * @since v0.3.0
 	 */
 	public String toString(final boolean showUncertainty,
 			RoundingMode roundingMode) {