From 751b112bc9b896b94bb39a01aee7dad92e8a42b8 Mon Sep 17 00:00:00 2001
From: Arnaud Giersch <arnaud.giersch@univ-fcomte.fr>
Date: Thu, 4 Jul 2019 09:08:43 +0200
Subject: [PATCH] [sonar] Add @deprecated in javadoc.

---
 src/bindings/java/org/simgrid/msg/Comm.java      | 5 ++++-
 src/bindings/java/org/simgrid/msg/Mutex.java     | 1 +
 src/bindings/java/org/simgrid/msg/RngStream.java | 1 +
 src/bindings/java/org/simgrid/msg/Semaphore.java | 5 ++++-
 src/bindings/java/org/simgrid/msg/Task.java      | 5 ++++-
 src/bindings/java/org/simgrid/msg/VM.java        | 5 ++++-
 6 files changed, 18 insertions(+), 4 deletions(-)

diff --git a/src/bindings/java/org/simgrid/msg/Comm.java b/src/bindings/java/org/simgrid/msg/Comm.java
index 2338380dcc..3346facc8a 100644
--- a/src/bindings/java/org/simgrid/msg/Comm.java
+++ b/src/bindings/java/org/simgrid/msg/Comm.java
@@ -29,7 +29,10 @@ public class Comm {
 	protected Comm() {
 
 	}
-	/** Destroy the C communication object, when the GC reclaims the java part. */
+	/**
+	 * Destroy the C communication object, when the GC reclaims the java part.
+	 * @deprecated (from Java9 onwards)
+	 */
 	@Deprecated @Override
 	protected void finalize() throws Throwable{
 		nativeFinalize();
diff --git a/src/bindings/java/org/simgrid/msg/Mutex.java b/src/bindings/java/org/simgrid/msg/Mutex.java
index b7d9f5c127..e23d1fc846 100644
--- a/src/bindings/java/org/simgrid/msg/Mutex.java
+++ b/src/bindings/java/org/simgrid/msg/Mutex.java
@@ -18,6 +18,7 @@ public class Mutex {
 		init();
 	}
 
+	/** @deprecated (from Java9 onwards) */
 	@Deprecated @Override
 	protected void finalize() throws Throwable {
 		nativeFinalize();
diff --git a/src/bindings/java/org/simgrid/msg/RngStream.java b/src/bindings/java/org/simgrid/msg/RngStream.java
index 0fbfd311ac..2209f49472 100644
--- a/src/bindings/java/org/simgrid/msg/RngStream.java
+++ b/src/bindings/java/org/simgrid/msg/RngStream.java
@@ -42,6 +42,7 @@ public class RngStream {
 	 */
 	private native void create(String name);
 
+	/** @deprecated (from Java9 onwards) */
 	@Deprecated @Override
 	protected void finalize() throws Throwable{
 		nativeFinalize();
diff --git a/src/bindings/java/org/simgrid/msg/Semaphore.java b/src/bindings/java/org/simgrid/msg/Semaphore.java
index 7811aed323..c348bd4cfb 100644
--- a/src/bindings/java/org/simgrid/msg/Semaphore.java
+++ b/src/bindings/java/org/simgrid/msg/Semaphore.java
@@ -66,7 +66,10 @@ public class Semaphore {
 	}
 
 
-	/** Deletes this semaphore when the GC reclaims it */
+	/**
+	 * Deletes this semaphore when the GC reclaims it
+	 * @deprecated (from Java9 onwards)
+	 */
 	@Deprecated @Override
 	protected void finalize() throws Throwable {
 		nativeFinalize();
diff --git a/src/bindings/java/org/simgrid/msg/Task.java b/src/bindings/java/org/simgrid/msg/Task.java
index 4c1dfeaa15..5bb5d2911b 100644
--- a/src/bindings/java/org/simgrid/msg/Task.java
+++ b/src/bindings/java/org/simgrid/msg/Task.java
@@ -180,7 +180,10 @@ public class Task {
 	/** Cancels a task. */
 	public native void cancel();
 
-	/** Deletes a task once the garbage collector reclaims it */
+	/**
+	 * Deletes a task once the garbage collector reclaims it
+	 * @deprecated (from Java9 onwards)
+	 */
 	@Deprecated @Override
 	protected void finalize() throws Throwable{
 		nativeFinalize();
diff --git a/src/bindings/java/org/simgrid/msg/VM.java b/src/bindings/java/org/simgrid/msg/VM.java
index bca633f62f..f0a778b9a3 100644
--- a/src/bindings/java/org/simgrid/msg/VM.java
+++ b/src/bindings/java/org/simgrid/msg/VM.java
@@ -67,7 +67,10 @@ public class VM extends Host {
 	/** Retrieve a VM from its name */
 	public static native VM getVMByName(String name);
 
-	/* Make sure that the GC also destroys the C object */
+	/**
+	 * Make sure that the GC also destroys the C object
+	 * @deprecated (from Java9 onwards)
+	 */
 	@Deprecated @Override
 	protected void finalize() throws Throwable {
 		nativeFinalize();
-- 
2.20.1