Subject: [PATCH] Deprecated annotation
---
Index: src/org/openstreetmap/josm/data/coor/LatLon.java
IDEA additional info:
Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP
<+>UTF-8
===================================================================
diff --git a/src/org/openstreetmap/josm/data/coor/LatLon.java b/src/org/openstreetmap/josm/data/coor/LatLon.java
--- a/src/org/openstreetmap/josm/data/coor/LatLon.java	(revision 19301)
+++ b/src/org/openstreetmap/josm/data/coor/LatLon.java	(date 1738170841447)
@@ -177,7 +177,7 @@
      * values, only differing by no more than 1 / {@link #MAX_SERVER_PRECISION MAX_SERVER_PRECISION}.
      * @deprecated since 18464 (use {@link ILatLon#equalsEpsilon(ILatLon)} instead)
      */
-    @Deprecated
+    @Deprecated(since = "18464")
     public boolean equalsEpsilon(LatLon other) {
         return ILatLon.super.equalsEpsilon(other);
     }
@@ -187,7 +187,7 @@
      * @return <code>true</code>, if the coordinate is outside the world, compared by using lat/lon.
      * @deprecated use {@link Node#isOutSideWorld} instead, see also #13538.
      */
-    @Deprecated
+    @Deprecated(since = "15449")
     public boolean isOutSideWorld() {
         Bounds b = ProjectionRegistry.getProjection().getWorldBoundsLatLon();
         return lat() < b.getMinLat() || lat() > b.getMaxLat() ||
@@ -220,7 +220,7 @@
      * @return distance in metres.
      * @deprecated since 18494 (use {@link ILatLon#greatCircleDistance(ILatLon)} instead)
      */
-    @Deprecated
+    @Deprecated(since = "18494")
     public double greatCircleDistance(LatLon other) {
         return ILatLon.super.greatCircleDistance(other);
     }
@@ -241,7 +241,7 @@
      * @since 9796
      * @deprecated since 18494 (use {@link ILatLon#bearing(ILatLon)} instead)
      */
-    @Deprecated
+    @Deprecated(since = "18494")
     public double bearing(LatLon other) {
         return ILatLon.super.bearing(other);
     }
Index: src/org/openstreetmap/josm/data/gpx/GpxImageEntry.java
IDEA additional info:
Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP
<+>UTF-8
===================================================================
diff --git a/src/org/openstreetmap/josm/data/gpx/GpxImageEntry.java b/src/org/openstreetmap/josm/data/gpx/GpxImageEntry.java
--- a/src/org/openstreetmap/josm/data/gpx/GpxImageEntry.java	(revision 19301)
+++ b/src/org/openstreetmap/josm/data/gpx/GpxImageEntry.java	(date 1738168144537)
@@ -175,7 +175,7 @@
      * @return the GPS time value
      * @deprecated Use {@link #getGpsInstant}
      */
-    @Deprecated
+    @Deprecated(since = "17715")
     public Date getGpsTime() {
         if (tmp != null)
             return getDefensiveDate(tmp.gpsTime);
@@ -254,7 +254,7 @@
      * @since 6392
      * @deprecated Use {@link #getExifGpsInstant}
      */
-    @Deprecated
+    @Deprecated(since = "17715")
     public Date getExifGpsTime() {
         return getDefensiveDate(exifGpsTime);
     }
Index: src/org/openstreetmap/josm/data/gpx/ImmutableGpxTrack.java
IDEA additional info:
Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP
<+>UTF-8
===================================================================
diff --git a/src/org/openstreetmap/josm/data/gpx/ImmutableGpxTrack.java b/src/org/openstreetmap/josm/data/gpx/ImmutableGpxTrack.java
--- a/src/org/openstreetmap/josm/data/gpx/ImmutableGpxTrack.java	(revision 19301)
+++ b/src/org/openstreetmap/josm/data/gpx/ImmutableGpxTrack.java	(date 1738168186031)
@@ -10,7 +10,7 @@
  * @since 2907
  * @deprecated Use {@link GpxTrack} instead!
  */
-@Deprecated
+@Deprecated(since = "15496")
 public class ImmutableGpxTrack extends GpxTrack {
 
     /**
Index: src/org/openstreetmap/josm/data/gpx/WayPoint.java
IDEA additional info:
Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP
<+>UTF-8
===================================================================
diff --git a/src/org/openstreetmap/josm/data/gpx/WayPoint.java b/src/org/openstreetmap/josm/data/gpx/WayPoint.java
--- a/src/org/openstreetmap/josm/data/gpx/WayPoint.java	(revision 19301)
+++ b/src/org/openstreetmap/josm/data/gpx/WayPoint.java	(date 1738168222494)
@@ -137,7 +137,7 @@
      * @since 13210
      * @deprecated Use {@link #setInstant(Instant)}
      */
-    @Deprecated
+    @Deprecated(since = "17715")
     public void setTime(long ts) {
         setInstant(Instant.ofEpochSecond(ts));
     }
@@ -203,7 +203,7 @@
      * @since 14456
      * @deprecated Use {@link #getInstant()}
      */
-    @Deprecated
+    @Deprecated(since = "17715")
     public Date getDate() {
         Instant instant = getInstant();
         return instant == null ? null : Date.from(instant);
Index: src/org/openstreetmap/josm/data/oauth/OAuthVersion.java
IDEA additional info:
Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP
<+>UTF-8
===================================================================
diff --git a/src/org/openstreetmap/josm/data/oauth/OAuthVersion.java b/src/org/openstreetmap/josm/data/oauth/OAuthVersion.java
--- a/src/org/openstreetmap/josm/data/oauth/OAuthVersion.java	(revision 19301)
+++ b/src/org/openstreetmap/josm/data/oauth/OAuthVersion.java	(date 1738168274244)
@@ -11,7 +11,7 @@
      * <a href="https://oauth.net/core/1.0a/">OAuth 1.0a</a>
      * @deprecated The OSM API server has deprecated and will remove OAuth 1.0a support in June 2024.
      */
-    @Deprecated
+    @Deprecated(since = "18991")
     OAuth10a,
     /** <a href="https://datatracker.ietf.org/doc/html/rfc6749">OAuth 2.0</a> */
     OAuth20,
Index: src/org/openstreetmap/josm/data/osm/history/HistoryOsmPrimitive.java
IDEA additional info:
Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP
<+>UTF-8
===================================================================
diff --git a/src/org/openstreetmap/josm/data/osm/history/HistoryOsmPrimitive.java b/src/org/openstreetmap/josm/data/osm/history/HistoryOsmPrimitive.java
--- a/src/org/openstreetmap/josm/data/osm/history/HistoryOsmPrimitive.java	(revision 19301)
+++ b/src/org/openstreetmap/josm/data/osm/history/HistoryOsmPrimitive.java	(date 1738168392646)
@@ -160,7 +160,7 @@
      * @return the timestamp
      * @deprecated Use {@link #getInstant()}
      */
-    @Deprecated
+    @Deprecated(since = "17838")
     public Date getTimestamp() {
         return Date.from(timestamp);
     }
Index: src/org/openstreetmap/josm/data/osm/OsmUtils.java
IDEA additional info:
Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP
<+>UTF-8
===================================================================
diff --git a/src/org/openstreetmap/josm/data/osm/OsmUtils.java b/src/org/openstreetmap/josm/data/osm/OsmUtils.java
--- a/src/org/openstreetmap/josm/data/osm/OsmUtils.java	(revision 19301)
+++ b/src/org/openstreetmap/josm/data/osm/OsmUtils.java	(date 1738170841453)
@@ -37,19 +37,19 @@
      * Discouraged synonym for {@link #TRUE_VALUE}
      * @deprecated since 18801, use {@link #TRUE_VALUE} instead.
      */
-    @Deprecated
+    @Deprecated(since = "18801")
     public static final String trueval = TRUE_VALUE;
     /**
      * Discouraged synonym for {@link #FALSE_VALUE}
      * @deprecated since 18801, use {@link #FALSE_VALUE} instead.
      */
-    @Deprecated
+    @Deprecated(since = "18801")
     public static final String falseval = FALSE_VALUE;
     /**
      * Discouraged synonym for {@link #REVERSE_VALUE}
      * @deprecated since 18801, use {@link #REVERSE_VALUE} instead.
      */
-    @Deprecated
+    @Deprecated(since = "18801")
     public static final String reverseval = REVERSE_VALUE;
 
     private OsmUtils() {
Index: src/org/openstreetmap/josm/data/protobuf/ProtobufPacked.java
IDEA additional info:
Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP
<+>UTF-8
===================================================================
diff --git a/src/org/openstreetmap/josm/data/protobuf/ProtobufPacked.java b/src/org/openstreetmap/josm/data/protobuf/ProtobufPacked.java
--- a/src/org/openstreetmap/josm/data/protobuf/ProtobufPacked.java	(revision 19301)
+++ b/src/org/openstreetmap/josm/data/protobuf/ProtobufPacked.java	(date 1738168480928)
@@ -22,7 +22,7 @@
      * @param bytes The packed bytes
      * @deprecated since we aren't using the output stream anymore
      */
-    @Deprecated
+    @Deprecated(since = "18695")
     public ProtobufPacked(ByteArrayOutputStream ignored, byte[] bytes) {
         this(bytes);
     }
Index: src/org/openstreetmap/josm/gui/io/importexport/GeoJSONImporter.java
IDEA additional info:
Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP
<+>UTF-8
===================================================================
diff --git a/src/org/openstreetmap/josm/gui/io/importexport/GeoJSONImporter.java b/src/org/openstreetmap/josm/gui/io/importexport/GeoJSONImporter.java
--- a/src/org/openstreetmap/josm/gui/io/importexport/GeoJSONImporter.java	(revision 19301)
+++ b/src/org/openstreetmap/josm/gui/io/importexport/GeoJSONImporter.java	(date 1738167947136)
@@ -43,7 +43,7 @@
      * @throws IllegalDataException if an error was found while parsing the data from the source
      * @deprecated since 18807, use {@link #parseDataSet(InputStream, ProgressMonitor)} instead
      */
-    @Deprecated
+    @Deprecated(since = "18807")
     public DataSet parseDataSet(final String source) throws IOException, IllegalDataException {
         try (CachedFile cf = new CachedFile(source)) {
             InputStream fileInputStream = Compression.getUncompressedFileInputStream(cf.getFile()); // NOPMD
Index: src/org/openstreetmap/josm/gui/mappaint/MapPaintStyles.java
IDEA additional info:
Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP
<+>UTF-8
===================================================================
diff --git a/src/org/openstreetmap/josm/gui/mappaint/MapPaintStyles.java b/src/org/openstreetmap/josm/gui/mappaint/MapPaintStyles.java
--- a/src/org/openstreetmap/josm/gui/mappaint/MapPaintStyles.java	(revision 19301)
+++ b/src/org/openstreetmap/josm/gui/mappaint/MapPaintStyles.java	(date 1738168459303)
@@ -238,7 +238,7 @@
      * @return {@code null} if no icon found
      * @deprecated use {@link OsmPrimitiveImageProvider#getResource}
      */
-    @Deprecated
+    @Deprecated(since = "15889")
     public static ImageIcon getNodeIcon(Tag tag) {
         if (tag != null) {
             return OsmPrimitiveImageProvider.getResource(tag.getKey(), tag.getValue(), OsmPrimitiveType.NODE)
Index: src/org/openstreetmap/josm/gui/oauth/FullyAutomaticAuthorizationUI.java
IDEA additional info:
Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP
<+>UTF-8
===================================================================
diff --git a/src/org/openstreetmap/josm/gui/oauth/FullyAutomaticAuthorizationUI.java b/src/org/openstreetmap/josm/gui/oauth/FullyAutomaticAuthorizationUI.java
--- a/src/org/openstreetmap/josm/gui/oauth/FullyAutomaticAuthorizationUI.java	(revision 19301)
+++ b/src/org/openstreetmap/josm/gui/oauth/FullyAutomaticAuthorizationUI.java	(date 1738168630513)
@@ -236,7 +236,7 @@
      * @since 5422
      * @deprecated since 18991
      */
-    @Deprecated
+    @Deprecated(since = "18991")
     public FullyAutomaticAuthorizationUI(String apiUrl, Executor executor) {
         this(apiUrl, executor, OAuthVersion.OAuth10a);
     }
Index: src/org/openstreetmap/josm/gui/oauth/ManualAuthorizationUI.java
IDEA additional info:
Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP
<+>UTF-8
===================================================================
diff --git a/src/org/openstreetmap/josm/gui/oauth/ManualAuthorizationUI.java b/src/org/openstreetmap/josm/gui/oauth/ManualAuthorizationUI.java
--- a/src/org/openstreetmap/josm/gui/oauth/ManualAuthorizationUI.java	(revision 19301)
+++ b/src/org/openstreetmap/josm/gui/oauth/ManualAuthorizationUI.java	(date 1738168597885)
@@ -56,7 +56,7 @@
      * @deprecated since 18991, use {@link ManualAuthorizationUI#ManualAuthorizationUI(String, Executor, OAuthVersion)}
      * instead.
      */
-    @Deprecated
+    @Deprecated(since = "18991")
     public ManualAuthorizationUI(String apiUrl, Executor executor) {
         this(apiUrl, executor, OAuthVersion.OAuth10a);
     }
Index: src/org/openstreetmap/josm/gui/tagging/ac/AutoCompletingComboBox.java
IDEA additional info:
Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP
<+>UTF-8
===================================================================
diff --git a/src/org/openstreetmap/josm/gui/tagging/ac/AutoCompletingComboBox.java b/src/org/openstreetmap/josm/gui/tagging/ac/AutoCompletingComboBox.java
--- a/src/org/openstreetmap/josm/gui/tagging/ac/AutoCompletingComboBox.java	(revision 19301)
+++ b/src/org/openstreetmap/josm/gui/tagging/ac/AutoCompletingComboBox.java	(date 1738168597875)
@@ -11,6 +11,6 @@
  * @deprecated Use the generic type {@link AutoCompComboBox} instead.  Eg.
  *             {@code AutoCompComboBox<AutoCompletionItem>} or {@code AutoCompComboBox<String>}.
  */
-@Deprecated
+@Deprecated(since = "18173")
 public class AutoCompletingComboBox extends AutoCompComboBox<AutoCompletionItem> {
 }
Index: src/org/openstreetmap/josm/gui/SplashScreen.java
IDEA additional info:
Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP
<+>UTF-8
===================================================================
diff --git a/src/org/openstreetmap/josm/gui/SplashScreen.java b/src/org/openstreetmap/josm/gui/SplashScreen.java
--- a/src/org/openstreetmap/josm/gui/SplashScreen.java	(revision 19301)
+++ b/src/org/openstreetmap/josm/gui/SplashScreen.java	(date 1738168427817)
@@ -283,7 +283,7 @@
          * @deprecated Use {@link #finishTask(String)} instead.
          */
         @Override
-        @Deprecated
+        @Deprecated(since = "8497")
         public void finishTask() {
             // Not used
         }
Index: src/org/openstreetmap/josm/io/auth/CredentialsAgent.java
IDEA additional info:
Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP
<+>UTF-8
===================================================================
diff --git a/src/org/openstreetmap/josm/io/auth/CredentialsAgent.java b/src/org/openstreetmap/josm/io/auth/CredentialsAgent.java
--- a/src/org/openstreetmap/josm/io/auth/CredentialsAgent.java	(revision 19301)
+++ b/src/org/openstreetmap/josm/io/auth/CredentialsAgent.java	(date 1738167947114)
@@ -65,7 +65,7 @@
      * @throws CredentialsAgentException if something goes wrong
      * @deprecated since 18991 -- OAuth 1.0 is being removed from the OSM API
      */
-    @Deprecated
+    @Deprecated(since = "18991")
     default IOAuthToken lookupOAuthAccessToken() throws CredentialsAgentException {
         throw new CredentialsAgentException("Call to deprecated method");
     }
@@ -89,7 +89,7 @@
      * @throws CredentialsAgentException if something goes wrong
      * @deprecated since 18991 -- OAuth 1.0 is being removed from the OSM API
      */
-    @Deprecated
+    @Deprecated(since = "18991")
     default void storeOAuthAccessToken(IOAuthToken accessToken) throws CredentialsAgentException {
         throw new CredentialsAgentException("Call to deprecated method");
     }
Index: test/unit/org/openstreetmap/josm/data/coor/LatLonTest.java
IDEA additional info:
Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP
<+>UTF-8
===================================================================
diff --git a/test/unit/org/openstreetmap/josm/data/coor/LatLonTest.java b/test/unit/org/openstreetmap/josm/data/coor/LatLonTest.java
--- a/test/unit/org/openstreetmap/josm/data/coor/LatLonTest.java	(revision 19301)
+++ b/test/unit/org/openstreetmap/josm/data/coor/LatLonTest.java	(date 1738170841457)
@@ -215,7 +215,7 @@
      * @deprecated to remove
      */
     @Test
-    @Deprecated
+    @Deprecated(since = "15451")
     void testIsOutSideWorld() {
         assertFalse(LatLon.ZERO.isOutSideWorld());
         assertTrue(LatLon.NORTH_POLE.isOutSideWorld());
Index: test/unit/org/openstreetmap/josm/testutils/ExpectedRootException.java
IDEA additional info:
Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP
<+>UTF-8
===================================================================
diff --git a/test/unit/org/openstreetmap/josm/testutils/ExpectedRootException.java b/test/unit/org/openstreetmap/josm/testutils/ExpectedRootException.java
--- a/test/unit/org/openstreetmap/josm/testutils/ExpectedRootException.java	(revision 19301)
+++ b/test/unit/org/openstreetmap/josm/testutils/ExpectedRootException.java	(date 1738168549998)
@@ -18,7 +18,7 @@
  * @see <a href="https://github.com/junit-team/junit4/pull/778">Github pull request</a>
  * @deprecated Use matchers instead with the return from {@link org.junit.jupiter.api.Assertions#assertThrows}
  */
-@Deprecated
+@Deprecated(since = "16618")
 public final class ExpectedRootException implements TestRule {
 
     private final ExpectedException rule = ExpectedException.none();
Index: test/unit/org/openstreetmap/josm/testutils/JOSMTestRules.java
IDEA additional info:
Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP
<+>UTF-8
===================================================================
diff --git a/test/unit/org/openstreetmap/josm/testutils/JOSMTestRules.java b/test/unit/org/openstreetmap/josm/testutils/JOSMTestRules.java
--- a/test/unit/org/openstreetmap/josm/testutils/JOSMTestRules.java	(revision 19301)
+++ b/test/unit/org/openstreetmap/josm/testutils/JOSMTestRules.java	(date 1738168517758)
@@ -299,7 +299,7 @@
      * @since 12556
      * @deprecated Use {@link #territories}
      */
-    @Deprecated
+    @Deprecated(since = "16321")
     public JOSMTestRules rlTraffic() {
         territories();
         return this;