diff --git a/auth/src/main/java/io/grpc/auth/ClientAuthInterceptor.java b/auth/src/main/java/io/grpc/auth/ClientAuthInterceptor.java
index ccd02f0f74..fe56b6f1bb 100644
--- a/auth/src/main/java/io/grpc/auth/ClientAuthInterceptor.java
+++ b/auth/src/main/java/io/grpc/auth/ClientAuthInterceptor.java
@@ -58,7 +58,7 @@ import java.util.concurrent.Executor;
  * <p>Uses the new and simplified Google auth library:
  * https://github.com/google/google-auth-library-java
  *
- * @deprecated use {@link GoogleAuthLibraryCallCredentials} instead.
+ * @deprecated use {@link MoreCallCredentials#from(Credentials)} instead.
  */
 @Deprecated
 public final class ClientAuthInterceptor implements ClientInterceptor {
diff --git a/core/src/main/java/io/grpc/CallCredentials.java b/core/src/main/java/io/grpc/CallCredentials.java
index 32defb4b2d..1d9b7a9134 100644
--- a/core/src/main/java/io/grpc/CallCredentials.java
+++ b/core/src/main/java/io/grpc/CallCredentials.java
@@ -37,6 +37,13 @@ import java.util.concurrent.Executor;
 
 /**
  * Carries credential data that will be propagated to the server via request metadata for each RPC.
+ *
+ * <p>This is used by {@link CallOptions#withCallCredentials} and {@code withCallCredentials()} on
+ * the generated stub, for example:
+ * <pre>
+ * FooGrpc.FooStub stub = FooGrpc.newStub(channel);
+ * response = stub.withCallCredentials(creds).bar(request);
+ * </pre>
  */
 @ExperimentalApi("https//github.com/grpc/grpc-java/issues/1914")
 public interface CallCredentials {