api: clarify that Server.shutdown() does not block on preexisting calls

dounan · dounan · commit 6784bca8ef80 · 2019-12-10T21:37:29.000-08:00
diff --git a/api/src/main/java/io/grpc/Server.java b/api/src/main/java/io/grpc/Server.java
@@ -104,8 +104,8 @@ public List<ServerServiceDefinition> getMutableServices() {
 
   /**
    * Initiates an orderly shutdown in which preexisting calls continue but new calls are rejected.
-   * After this call returns, this server has released the listening socket(s) and may be reused by
-   * another server.
+   * This call will not wait for preexisting calls finish before returning. After this call returns,
+   * this server has released the listening socket(s) and may be reused by another server.
    *
    * @return {@code this} object
    * @since 1.0.0
