[sonar] Add @deprecated in javadoc.

[simgrid.git] / src / bindings / java / org / simgrid / msg / Comm.java

diff --git a/src/bindings/java/org/simgrid/msg/Comm.java b/src/bindings/java/org/simgrid/msg/Comm.java
index 2ea34c3..3346fac 100644 (file)
--- a/src/bindings/java/org/simgrid/msg/Comm.java
+++ b/src/bindings/java/org/simgrid/msg/Comm.java
@@ -1,4 +1,4 @@
-/* Copyright (c) 2012-2014. The SimGrid Team.
+/* Copyright (c) 2012-2019. The SimGrid Team.
  * All rights reserved.                                                     */
 
 /* This program is free software; you can redistribute it and/or modify it
@@ -6,10 +6,7 @@
 
 package org.simgrid.msg;
 
-/**
- * Communication action, representing an ongoing communication
- * between processes.
- */
+/** Communication action, representing an ongoing communication between processes. */
 public class Comm {
        /** Indicates if the communication is a receiving communication */
        protected boolean receiving;
@@ -17,7 +14,7 @@ public class Comm {
        protected boolean finished = false;
        /**
         * Represents the bind between the java comm and the
-        * native C comm. You must never access it, since it is 
+        * native C comm. You must never access it, since it is
         * automatically set.
         */
        private long bind = 0;
@@ -32,7 +29,11 @@ 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();
        }
@@ -61,7 +62,7 @@ public class Comm {
                waitAll(comms, -1.);
        }
        /** Wait any of the communications, and return the rank of the terminating comm */
-       public static native void waitAny(Comm[] comms) throws TransferFailureException, HostFailureException, TimeoutException;
+       public static native int waitAny(Comm[] comms) throws TransferFailureException, HostFailureException, TimeoutException;
        /**
         * Returns the task associated with the communication.
         * if the communication isn't finished yet, will return null.