Address reference doc review comments (#1919)

Author: samtstern

firebase-database/src/main/java/com/google/firebase/database/FirebaseDatabase.java

@@ -305,12 +305,12 @@ public synchronized void setPersistenceCacheSizeBytes(long cacheSizeInBytes) {
   }
 
   /**
-   * Modify this FirebaseDatabase instance to communicate with the Realtime Database emulator.
+   * Modifies this FirebaseDatabase instance to communicate with the Realtime Database emulator.
    *
-   * <p>Note: this must be called before this instance has been used to do any database operations.
+   * <p>Note: Call this method before using the instance to do any database operations.
    *
-   * @param host the emulator host (ex: 10.0.2.2)
-   * @param port the emulator port (ex: 9000)
+   * @param host the emulator host (for example, 10.0.2.2)
+   * @param port the emulator port (for example, 9000)
    */
   public void useEmulator(@NonNull String host, int port) {
     if (this.repo != null) {

firebase-firestore/src/main/java/com/google/firebase/firestore/FirebaseFirestore.java

@@ -204,12 +204,12 @@ public void setFirestoreSettings(@NonNull FirebaseFirestoreSettings settings) {
   }
 
   /**
-   * Modify this FirebaseDatabase instance to communicate with the Cloud Firestore emulator.
+   * Modifies this FirebaseDatabase instance to communicate with the Cloud Firestore emulator.
    *
-   * <p>Note: this must be called before this instance has been used to do any operations.
+   * <p>Note: Call this method before using the instance to do any database operations.
    *
-   * @param host the emulator host (ex: 10.0.2.2)
-   * @param port the emulator port (ex: 8080)
+   * @param host the emulator host (for example, 10.0.2.2)
+   * @param port the emulator port (for example, 8080)
    */
   public void useEmulator(@NonNull String host, int port) {
     if (this.client != null) {

firebase-functions/src/main/java/com/google/firebase/functions/FirebaseFunctions.java

@@ -209,19 +209,19 @@ URL getURL(String function) {
     }
   }
 
-  /** @deprecated see {@link #useEmulator(String, int)} */
+  /** @deprecated Use {@link #useEmulator(String, int)} to connect to the emulator. */
   public void useFunctionsEmulator(@NonNull String origin) {
     Preconditions.checkNotNull(origin, "origin cannot be null");
     urlFormat = origin + "/%2$s/%1$s/%3$s";
   }
 
   /**
-   * Modify this FirebaseFunctions instance to communicate with the Cloud Functions emulator.
+   * Modifies this FirebaseFunctions instance to communicate with the Cloud Functions emulator.
    *
-   * <p>Note: this must be called before this instance has been used to do any operations.
+   * <p>Note: Call this method before using the instance to do any functions operations.
    *
-   * @param host the emulator host (ex: 10.0.2.2)
-   * @param port the emulator port (ex: 5001)
+   * @param host the emulator host (for example, 10.0.2.2)
+   * @param port the emulator port (for example, 5001)
    */
   public void useEmulator(@NonNull String host, int port) {
     this.emulatorSettings = new EmulatedServiceSettings(host, port);