Clarify documentation for View#setScreenReaderFocusable

Modify the document of this method, View#setScreenReaderFocusable,
To make as clear and precise as possible

Bug: 109898645
Test: Java Doc Build PASS
Change-Id: I683d420b6f1a4743d57dad9d06a343b85ec5da00

1 files changed, 5 insertions, 8 deletions

diff --git a/core/java/android/view/View.java b/core/java/android/view/View.java
index dfa51fff0a6b..70b1b154105b 100644
--- a/core/java/android/view/View.java
+++ b/core/java/android/view/View.java
@@ -12134,14 +12134,11 @@ public class View implements Drawable.Callback, KeyEvent.Callback,
     }
 
     /**
-     * When screen readers (one type of accessibility tool) decide what should be read to the
-     * user, they typically look for input focusable ({@link #isFocusable()}) parents of
-     * non-focusable text items, and read those focusable parents and their non-focusable children
-     * as a unit. In some situations, this behavior is desirable for views that should not take
-     * input focus. Setting an item to be screen reader focusable requests that the view be
-     * treated as a unit by screen readers without any effect on input focusability. The default
-     * value of {@code false} lets screen readers use other signals, like focusable, to determine
-     * how to group items.
+     * Sets whether this View should be a focusable element for screen readers
+     * and include non-focusable Views from its subtree when providing feedback.
+     * <p>
+     * Note: this is similar to using <a href="#attr_android:focusable">{@code android:focusable},
+     * but does not impact input focus behavior.
      *
      * @param screenReaderFocusable Whether the view should be treated as a unit by screen reader
      *                              accessibility tools.