Merge "Updated docs for Autofill inline Session/controller." into rvc-dev

services/autofill/java/com/android/server/autofill/AutofillInlineSessionController.java

@@ -31,9 +31,16 @@ import com.android.server.inputmethod.InputMethodManagerInternal;
 import java.util.Optional;
 import java.util.function.Consumer;
 
-
 /**
- * Controls the interaction with the IME for the inline suggestion sessions.
+ * Controls the interaction with the IME for the {@link AutofillInlineSuggestionsRequestSession}s.
+ *
+ * <p>The class maintains the inline suggestion session with the autofill service. There is at most
+ * one active inline suggestion session at any given  corresponding to one focused view.
+ * New sessions are created only when {@link #onCreateInlineSuggestionsRequestLocked} is called.</p>
+ *
+ * <p>The class manages the interaction between the {@link com.android.server.autofill.Session} and
+ * the inline suggestion session whenever inline suggestions can be provided. All calls to the
+ * inline suggestion session must be made through this controller.</p>
  */
 final class AutofillInlineSessionController {
     @NonNull
@@ -66,7 +73,6 @@ final class AutofillInlineSessionController {
         mUiCallback = callback;
     }
 
-
     /**
      * Requests the IME to create an {@link InlineSuggestionsRequest} for {@code autofillId}.
      *

services/autofill/java/com/android/server/autofill/AutofillInlineSuggestionsRequestSession.java

@@ -364,6 +364,9 @@ final class AutofillInlineSuggestionsRequestSession {
         }
     }
 
+    /**
+     * Internal implementation of {@link IInlineSuggestionsRequestCallback}.
+     */
     private static final class InlineSuggestionsRequestCallbackImpl extends
             IInlineSuggestionsRequestCallback.Stub {