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, 24 insertions, 0 deletions

diff --git a/src/main/java/sevenUnits/unit/UnitDatabase.java b/src/main/java/sevenUnits/unit/UnitDatabase.java
index 6cf794b..b0d026f 100644
--- a/src/main/java/sevenUnits/unit/UnitDatabase.java
+++ b/src/main/java/sevenUnits/unit/UnitDatabase.java
@@ -138,6 +138,7 @@ public final class UnitDatabase {
 				
 				/**
 				 * @since 2019-05-03
+				 * @since v0.3.0
 				 */
 				@Override
 				public boolean equals(final Object o) {
@@ -160,6 +161,7 @@ public final class UnitDatabase {
 				
 				/**
 				 * @since 2019-05-03
+				 * @since v0.3.0
 				 */
 				@Override
 				public int hashCode() {
@@ -181,6 +183,7 @@ public final class UnitDatabase {
 				 * value.
 				 * 
 				 * @since 2019-05-03
+				 * @since v0.3.0
 				 */
 				@Override
 				public String toString() {
@@ -307,6 +310,7 @@ public final class UnitDatabase {
 				 * @return the next element in the iterator, without iterating over
 				 *         it
 				 * @since 2019-05-03
+				 * @since v0.3.0
 				 */
 				private Entry<String, Unit> peek() {
 					if (!this.hasNext())
@@ -333,6 +337,7 @@ public final class UnitDatabase {
 				 * of the representation are unspecified and subject to change.
 				 * 
 				 * @since 2019-05-03
+				 * @since v0.3.0
 				 */
 				@Override
 				public String toString() {
@@ -622,6 +627,7 @@ public final class UnitDatabase {
 				 * @return the next element in the iterator, without iterating over
 				 *         it
 				 * @since 2019-05-03
+				 * @since v0.3.0
 				 */
 				private String peek() {
 					if (!this.hasNext())
@@ -645,6 +651,7 @@ public final class UnitDatabase {
 				 * of the representation are unspecified and subject to change.
 				 * 
 				 * @since 2019-05-03
+				 * @since v0.3.0
 				 */
 				@Override
 				public String toString() {
@@ -1136,6 +1143,7 @@ public final class UnitDatabase {
 	 * @param exponentUnit exponent
 	 * @return result
 	 * @since 2020-08-04
+	 * @since v0.3.0
 	 */
 	private static final LinearUnitValue exponentiateUnitValues(
 			final LinearUnitValue base, final LinearUnitValue exponentValue) {
@@ -1151,6 +1159,7 @@ public final class UnitDatabase {
 	/**
 	 * @return true if entry represents a removable duplicate entry of map.
 	 * @since 2021-05-22
+	 * @since v0.3.0
 	 */
 	static <T> boolean isRemovableDuplicate(Map<String, T> map,
 			Entry<String, T> entry) {
@@ -1236,6 +1245,7 @@ public final class UnitDatabase {
 	 * A parser that can parse unit value expressions.
 	 * 
 	 * @since 2020-08-04
+	 * @since v0.3.0
 	 */
 	private final ExpressionParser<LinearUnitValue> unitValueExpressionParser = new ExpressionParser.Builder<>(
 			this::getLinearUnitValue)
@@ -1297,6 +1307,7 @@ public final class UnitDatabase {
 	 * @param prefixRepetitionRule the rule that determines when prefix
 	 *                             repetition is allowed
 	 * @since 2020-08-26
+	 * @since v0.3.0
 	 */
 	public UnitDatabase(Predicate<List<UnitPrefix>> prefixRepetitionRule) {
 		this.prefixlessUnits = new HashMap<>();
@@ -1468,6 +1479,7 @@ public final class UnitDatabase {
 	 * @param name  name of unit set
 	 * @param value unit set to add
 	 * @since 2024-08-16
+	 * @since v1.0.0
 	 */
 	public void addUnitSet(String name, List<LinearUnit> value) {
 		if (value.isEmpty())
@@ -1486,6 +1498,7 @@ public final class UnitDatabase {
 	 * Removes all units, unit sets, prefixes and dimensions from this database.
 	 * 
 	 * @since 2022-02-26
+	 * @since v0.4.0
 	 */
 	public void clear() {
 		this.dimensions.clear();
@@ -1538,6 +1551,7 @@ public final class UnitDatabase {
 	 * @return true iff there is a unit set with this name
 	 *
 	 * @since 2024-08-16
+	 * @since v1.0.0
 	 */
 	public boolean containsUnitSetName(String name) {
 		return this.unitSets.containsKey(name);
@@ -1559,6 +1573,7 @@ public final class UnitDatabase {
 	 * @param expression expression to parse
 	 * @return {@code LinearUnitValue} representing value of expression
 	 * @since 2020-08-04
+	 * @since v0.3.0
 	 */
 	public LinearUnitValue evaluateUnitExpression(final String expression) {
 		Objects.requireNonNull(expression, "expression must not be null.");
@@ -1697,6 +1712,7 @@ public final class UnitDatabase {
 	 * @param name name of unit
 	 * @return {@code LinearUnitValue} instance
 	 * @since 2020-08-04
+	 * @since v0.3.0
 	 */
 	LinearUnitValue getLinearUnitValue(final String name) {
 		try {
@@ -1735,6 +1751,7 @@ public final class UnitDatabase {
 	 * @param unitName name of unit
 	 * @return prefixes
 	 * @since 2020-08-26
+	 * @since v0.3.0
 	 */
 	List<UnitPrefix> getPrefixesFromName(final String unitName) {
 		final List<UnitPrefix> prefixes = new ArrayList<>();
@@ -1800,6 +1817,7 @@ public final class UnitDatabase {
 	/**
 	 * @return the prefixRepetitionRule
 	 * @since 2020-08-26
+	 * @since v0.3.0
 	 */
 	public final Predicate<List<UnitPrefix>> getPrefixRepetitionRule() {
 		return this.prefixRepetitionRule;
@@ -1904,6 +1922,7 @@ public final class UnitDatabase {
 	 * @return unit set with that name
 	 *
 	 * @since 2024-08-16
+	 * @since v1.0.0
 	 */
 	public List<LinearUnit> getUnitSet(String name) {
 		final List<LinearUnit> unitSet = this.unitSets.get(name);
@@ -1916,6 +1935,7 @@ public final class UnitDatabase {
 	 * Parses a semicolon-separated expression to get the unit set being used.
 	 *
 	 * @since 2024-08-22
+	 * @since v1.0.0
 	 */
 	List<LinearUnit> getUnitSetFromExpression(String expression) {
 		final String[] parts = expression.split(";");
@@ -1991,6 +2011,7 @@ public final class UnitDatabase {
 	 * @param stream stream to load from
 	 * @return list of all errors that happened loading the stream
 	 * @since 2021-03-27
+	 * @since v0.3.0
 	 */
 	public List<LoadingException> loadDimensionsFromStream(
 			final InputStream stream) {
@@ -2062,6 +2083,7 @@ public final class UnitDatabase {
 	 * @param stream stream to load from
 	 * @return list of all errors that happened loading the stream
 	 * @since 2021-03-27
+	 * @since v0.3.0
 	 */
 	public List<LoadingException> loadUnitsFromStream(InputStream stream) {
 		final List<LoadingException> errors = new ArrayList<>();
@@ -2098,6 +2120,7 @@ public final class UnitDatabase {
 	/**
 	 * @param prefixRepetitionRule the prefixRepetitionRule to set
 	 * @since 2020-08-26
+	 * @since v0.3.0
 	 */
 	public final void setPrefixRepetitionRule(
 			Predicate<List<UnitPrefix>> prefixRepetitionRule) {
@@ -2169,6 +2192,7 @@ public final class UnitDatabase {
 	/**
 	 * @return an unmodifiable map mapping names to unit sets
 	 * @since 2024-08-16
+	 * @since v1.0.0
 	 */
 	public Map<String, List<LinearUnit>> unitSetMap() {
 		return Collections.unmodifiableMap(this.unitSets);