diff --git a/core/src/main/java/io/grpc/CallOptions.java b/core/src/main/java/io/grpc/CallOptions.java index 5e5f6ef31e..3753f7cd49 100644 --- a/core/src/main/java/io/grpc/CallOptions.java +++ b/core/src/main/java/io/grpc/CallOptions.java @@ -105,6 +105,10 @@ public final class CallOptions { /** * Sets the compression to use for the call. The compressor must be a valid name known in the * {@link CompressorRegistry}. + * + *

It is only safe to call this if the server supports the compression format chosen. There is + * no negotiation performed; if the server does not support the compression chosen, the call will + * fail. */ @ExperimentalApi("https://github.com/grpc/grpc-java/issues/1704") public CallOptions withCompression(@Nullable String compressorName) {