diff --git a/include/grpc/grpc.h b/include/grpc/grpc.h
index ac9f0d83a9dc679c8b8ad7489aa3e53fb0505e97..3b09d51a1431f539e87539f87f13f32b844e2d77 100644
--- a/include/grpc/grpc.h
+++ b/include/grpc/grpc.h
@@ -439,10 +439,13 @@ int grpc_server_add_secure_http2_port(grpc_server *server, const char *addr);
 /* Start a server - tells all listeners to start listening */
 void grpc_server_start(grpc_server *server);
 
-/* Begin shutting down a server. */
+/* Begin shutting down a server.
+   After completion, no new calls or connections will be admitted.
+   Existing calls will be allowed to complete. */
 void grpc_server_shutdown(grpc_server *server);
 
-/* Destroy a server */
+/* Destroy a server.
+   Forcefully cancels all existing calls. */
 void grpc_server_destroy(grpc_server *server);
 
 #ifdef __cplusplus