Merge "Updated docs for IInlineSuggestionsRequestCallback.aidl." into rvc-dev am: f65210f9ca am: eecfa86e8c

Original change: https://googleplex-android-review.googlesource.com/c/platform/frameworks/base/+/12142032

Change-Id: I70c1072749ecd64c755a2f3e9f0fea95a6ab9bcd

1 files changed, 32 insertions, 19 deletions

diff --git a/core/java/com/android/internal/view/IInlineSuggestionsRequestCallback.aidl b/core/java/com/android/internal/view/IInlineSuggestionsRequestCallback.aidl
index 03948a92bcab..6c97962ac057 100644
--- a/core/java/com/android/internal/view/IInlineSuggestionsRequestCallback.aidl
+++ b/core/java/com/android/internal/view/IInlineSuggestionsRequestCallback.aidl
@@ -22,41 +22,54 @@ import android.view.inputmethod.InlineSuggestionsRequest;
 import com.android.internal.view.IInlineSuggestionsResponseCallback;
 
 /**
- * Binder interface for the IME service to send an inline suggestion request to the system.
+ * Binder interface for the IME service to send {@link InlineSuggestionsRequest} or notify other IME
+ * service events to the system.
  * {@hide}
  */
 oneway interface IInlineSuggestionsRequestCallback {
-    // Indicates that the current IME does not support inline suggestion.
+    /** Indicates that the current IME does not support inline suggestion. */
     void onInlineSuggestionsUnsupported();
 
-    // Sends the inline suggestions request from IME to Autofill. Calling this method indicates
-    // that the IME input is started on the view corresponding to the request.
+    /**
+     * Sends the inline suggestions request from IME to Autofill. Calling this method indicates
+     * that the IME input is started on the view corresponding to the request.
+     */
     void onInlineSuggestionsRequest(in InlineSuggestionsRequest request,
             in IInlineSuggestionsResponseCallback callback);
 
-    // Signals that {@link android.inputmethodservice.InputMethodService
-    //  #onStartInput(EditorInfo, boolean)} is called on the given focused field.
+    /**
+     * Signals that {@link android.inputmethodservice.InputMethodService
+     * #onStartInput(EditorInfo, boolean)} is called on the given focused field.
+     */
     void onInputMethodStartInput(in AutofillId imeFieldId);
 
-    // Signals that {@link android.inputmethodservice.InputMethodService
-    //  #dispatchOnShowInputRequested(int, boolean)} is called and shares the call result.
-    //  The true value of {@code requestResult} means the IME is about to be shown, while
-    //  false value means the IME will not be shown.
+    /**
+     * Signals that {@link android.inputmethodservice.InputMethodService
+     * #dispatchOnShowInputRequested(int, boolean)} is called and shares the call result.
+     * The true value of {@code requestResult} means the IME is about to be shown, while
+     * false value means the IME will not be shown.
+     */
     void onInputMethodShowInputRequested(boolean requestResult);
 
-    // Signals that {@link android.inputmethodservice.InputMethodService
-    //  #onStartInputView(EditorInfo, boolean)} is called on the field specified by the earlier
-    //  {@link #onInputMethodStartInput(AutofillId)}.
+    /**
+     * Signals that {@link android.inputmethodservice.InputMethodService
+     * #onStartInputView(EditorInfo, boolean)} is called on the field specified by the earlier
+     * {@link #onInputMethodStartInput(AutofillId)}.
+     */
     void onInputMethodStartInputView();
 
-    // Signals that {@link android.inputmethodservice.InputMethodService
-    //  #onFinishInputView(boolean)} is called on the field specified by the earlier
-    //  {@link #onInputMethodStartInput(AutofillId)}.
+    /**
+     * Signals that {@link android.inputmethodservice.InputMethodService
+     * #onFinishInputView(boolean)} is called on the field specified by the earlier
+     * {@link #onInputMethodStartInput(AutofillId)}.
+     */
     void onInputMethodFinishInputView();
 
-    // Signals that {@link android.inputmethodservice.InputMethodService
-    //  #onFinishInput()} is called on the field specified by the earlier
-    //  {@link #onInputMethodStartInput(AutofillId)}.
+    /**
+     * Signals that {@link android.inputmethodservice.InputMethodService
+     * #onFinishInput()} is called on the field specified by the earlier
+     * {@link #onInputMethodStartInput(AutofillId)}.
+     */
     void onInputMethodFinishInput();
 
     // Indicates that the current IME changes inline suggestion session.