Bug 4213 - Properly document ice_invoke_async return code

1 files changed, 7 insertions, 11 deletions

diff --git a/java/src/Ice/ObjectPrxHelperBase.java b/java/src/Ice/ObjectPrxHelperBase.java
index 63a8f606801..b7c01ab8553 100644
--- a/java/src/Ice/ObjectPrxHelperBase.java
+++ b/java/src/Ice/ObjectPrxHelperBase.java
@@ -306,7 +306,7 @@ public class ObjectPrxHelperBase implements ObjectPrx, java.io.Serializable
      * for the operation. The return value follows any out-parameters.
      * @param __context The context map for the invocation.
      * @return If the operation was invoked synchronously (because there
-     * was no need to queue the request, the return value is <code>true</code>;
+     * was no need to queue the request), the return value is <code>true</code>;
      * otherwise, if the invocation was queued, the return value is <code>false</code>.
      *
      * @see Blobject
@@ -362,11 +362,9 @@ public class ObjectPrxHelperBase implements ObjectPrx, java.io.Serializable
      * @param operation The name of the operation to invoke.
      * @param mode The operation mode (normal or idempotent).
      * @param inParams The encoded in-parameters for the operation.
-     * @return If the operation completed successfully, the return value
-     * is <code>true</code>. If the operation raises a user exception,
-     * the return value is <code>false</code>; in this case, <code>outParams</code>
-     * contains the encoded user exception. If the operation raised an
-     * it throws it directly.
+     * @return If the operation was invoked synchronously (because there
+     * was no need to queue the request), the return value is <code>true</code>;
+     * otherwise, if the invocation was queued, the return value is <code>false</code>.
      *
      * @see AMI_Object_ice_invoke
      * @see OperationMode
@@ -386,11 +384,9 @@ public class ObjectPrxHelperBase implements ObjectPrx, java.io.Serializable
      * @param mode The operation mode (normal or idempotent).
      * @param inParams The encoded in-parameters for the operation.
      * @param __context The context map for the invocation.
-     * @return If the operation completed successfully, the return value
-     * is <code>true</code>. If the operation raises a user exception,
-     * the return value is <code>false</code>; in this case, <code>outParams</code>
-     * contains the encoded user exception. If the operation raised an
-     * it throws it directly.
+     * @return If the operation was invoked synchronously (because there
+     * was no need to queue the request), the return value is <code>true</code>;
+     * otherwise, if the invocation was queued, the return value is <code>false</code>.
      *
      * @see AMI_Object_ice_invoke
      * @see OperationMode