---

Ajay Kannan · Ajay Kannan · commit ddd10c89be7c · 2016-03-07T08:27:49.000-08:00
yaml --- r: 1751 b: refs/heads/master c: 8c353ec h: refs/heads/master i: 1749: 6c58cd2 1747: d3d1a93 1743: 5cad5ce
diff --git a/[refs] b/[refs]
@@ -1,5 +1,5 @@
 ---
-refs/heads/master: c486452b4c81da7f077e2573b1f29dee3994bd86
+refs/heads/master: 8c353ecbc62a9f8d7784ba8f99ee2f3cf15a4c00
 refs/heads/travis: e21ee7b88a5edc3f3d8c71f90c3fc32abf7e8dd6
 refs/heads/gh-pages: d1b373c30c176edc08692348167bec3a244bb823
 refs/heads/bigquery: 762fa5830e6c398c0396177e3e7fd243bd62cfc3
diff --git a/trunk/gcloud-java-core/src/main/java/com/google/gcloud/AuthCredentials.java b/trunk/gcloud-java-core/src/main/java/com/google/gcloud/AuthCredentials.java
@@ -132,6 +132,12 @@ public RestorableState<AuthCredentials> capture() {
     }
   }
 
+  /**
+   * Represents service account credentials.
+   *
+   * @see <a href="https://cloud.google.com/docs/authentication#user_accounts_and_service_accounts">
+   *     User accounts and service accounts</a>
+   */
   public static class ServiceAccountAuthCredentials extends AuthCredentials {
 
     private final String account;
@@ -195,6 +201,14 @@ public RestorableState<AuthCredentials> capture() {
     }
   }
 
+  /**
+   * Represents Application Default Credentials, which are credentials that are inferred from the
+   * runtime environment.
+   *
+   * @see <a
+   *     href="https://developers.google.com/identity/protocols/application-default-credentials">
+   *     Google Application Default Credentials</a>
+   */
   public static class ApplicationDefaultAuthCredentials extends AuthCredentials {
 
     private GoogleCredentials googleCredentials;
@@ -243,6 +257,11 @@ public RestorableState<AuthCredentials> capture() {
     }
   }
 
+  /**
+   * Represents that requests sent to the server should not be authenticated. This is typically
+   * useful when using the local service emulators, such as {@code LocalGcdHelper} and
+   * {@code LocalResourceManagerHelper}.
+   */
   public static class NoAuthCredentials extends AuthCredentials {
 
     private static final AuthCredentials INSTANCE = new NoAuthCredentials();
@@ -309,7 +328,9 @@ public static ServiceAccountAuthCredentials createFor(String account, PrivateKey
   }
 
   /**
-   * Creates a placeholder denoting that no credentials should be used.
+   * Creates a placeholder denoting that no credentials should be used. This is typically useful
+   * when using the local service emulators, such as {@code LocalGcdHelper} and
+   * {@code LocalResourceManagerHelper}.
    */
   public static AuthCredentials noAuth() {
     return NoAuthCredentials.INSTANCE;
