Updated API docs (firebase#82)

* Updated API docs

* Minor changes to apidoc text

Author: hiranya911

src/main/java/com/google/firebase/FirebaseOptions.java

@@ -193,6 +193,17 @@ public Builder setStorageBucket(String storageBucket) {
       return this;
     }
 
+    /**
+     * Sets the <code>GoogleCredentials</code> to use to authenticate the SDK.
+     *
+     * <p>See <a href="https://firebase.google.com/docs/admin/setup#initialize_the_sdk">
+     * Initialize the SDK</a> for code samples and detailed documentation.
+     *
+     * @param credentials A
+     *     <a href="http://google.github.io/google-auth-library-java/releases/0.7.1/apidocs/com/google/auth/oauth2/GoogleCredentials.html">{@code GoogleCredentials}</a>
+     *     instance used to authenticate the SDK.
+     * @return This <code>Builder</code> instance is returned so subsequent calls can be chained.
+     */
     public Builder setCredentials(GoogleCredentials credentials) {
       this.credentials = checkNotNull(credentials);
       return this;
@@ -201,9 +212,6 @@ public Builder setCredentials(GoogleCredentials credentials) {
     /**
      * Sets the <code>FirebaseCredential</code> to use to authenticate the SDK.
      *
-     * <p>See <a href="https://firebase.google.com/docs/admin/setup#initialize_the_sdk">
-     * Initialize the SDK</a> for code samples and detailed documentation.
-     *
      * @param credential A <code>FirebaseCredential</code> used to authenticate the SDK. See {@link
      *     FirebaseCredentials} for default implementations.
      * @return This <code>Builder</code> instance is returned so subsequent calls can be chained.

src/main/java/com/google/firebase/ThreadManager.java

@@ -28,7 +28,9 @@
 /**
  * An interface that controls the thread pools and thread factories used by the Admin SDK. Each
  * instance of {@link FirebaseApp} uses an implementation of this interface to create and manage
- * threads. Multiple app instances may use the same <code>ThreadManager</code> instance.
+ * threads.
+ *
+ * <p>Multiple app instances may use the same <code>ThreadManager</code> instance.
  * Methods in this interface may get invoked multiple times by the same
  * app, during its lifetime. Apps may also invoke methods of this interface concurrently, and
  * therefore implementations should provide any synchronization necessary.

src/main/java/com/google/firebase/auth/FirebaseCredential.java

@@ -23,7 +23,7 @@
  * you will not need to implement this yourself and can instead use the default implementations
  * provided by {@link FirebaseCredentials}.
  *
- * @deprecated Use GoogleCredentials
+ * @deprecated Use <a href="http://google.github.io/google-auth-library-java/releases/0.7.1/apidocs/com/google/auth/oauth2/GoogleCredentials.html">{@code GoogleCredentials}</a>.
  */
 public interface FirebaseCredential {
 

src/main/java/com/google/firebase/auth/FirebaseCredentials.java

@@ -37,7 +37,7 @@
  * Standard {@link FirebaseCredential} implementations for use with {@link
  * com.google.firebase.FirebaseOptions}.
  *
- * @deprecated Use GoogleCredentials.
+ * @deprecated Use <a href="http://google.github.io/google-auth-library-java/releases/0.7.1/apidocs/com/google/auth/oauth2/GoogleCredentials.html">{@code GoogleCredentials}</a>.
  */
 public class FirebaseCredentials {
 

src/main/java/com/google/firebase/tasks/Task.java

@@ -25,9 +25,10 @@
  * Represents an asynchronous operation.
  *
  * @param <T> the type of the result of the operation
- * @deprecated Task has been deprecated in favor of ApiFuture. For every method xyz() that returns
- *     a {@code Task<T>}, you should be able to find a corresponding xyzAsync() method that returns
- *     an {@code ApiFuture<T>}.
+ * @deprecated {@code Task} has been deprecated in favor of
+ *     <a href="https://googleapis.github.io/api-common-java/1.1.0/apidocs/com/google/api/core/ApiFuture.html">{@code ApiFuture}</a>.
+ *     For every method x() that returns a {@code Task<T>}, you should be able to find a
+ *     corresponding xAsync() method that returns an {@code ApiFuture<T>}.
  */
 public abstract class Task<T> {