Unhide findPath() API. Add JavaDoc to related features.
Also remove comments that disallow folders in search results.
Test: It builds.
Bug: 30948740
Bug: 32512923
Change-Id: I72706b69163aa98ee9568939e09e5048b6e8f9f8
diff --git a/core/java/android/content/Intent.java b/core/java/android/content/Intent.java
index e031275..4eecd48 100644
--- a/core/java/android/content/Intent.java
+++ b/core/java/android/content/Intent.java
@@ -3120,6 +3120,11 @@
* URIs that can be opened with
* {@link ContentResolver#openFileDescriptor(Uri, String)}.
* <p>
+ * Callers can set a document URI through {@link #setData(Uri)} to indicate
+ * the initial location of documents navigator. System will do its best to
+ * launch the navigator in the specified document if it's a folder, or the
+ * folder that contains the specified document if not.
+ * <p>
* Output: The URI of the item that was picked, returned in
* {@link #getData()}. This must be a {@code content://} URI so that any
* receiver can access it. If multiple documents were selected, they are
@@ -3156,6 +3161,11 @@
* URIs that can be opened with
* {@link ContentResolver#openFileDescriptor(Uri, String)}.
* <p>
+ * Callers can set a document URI through {@link #setData(Uri)} to indicate
+ * the initial location of documents navigator. System will do its best to
+ * launch the navigator in the specified document if it's a folder, or the
+ * folder that contains the specified document if not.
+ * <p>
* Output: The URI of the item that was created. This must be a
* {@code content://} URI so that any receiver can access it.
*
@@ -3178,6 +3188,11 @@
* {@link DocumentsContract#buildChildDocumentsUriUsingTree(Uri, String)}
* with the returned URI.
* <p>
+ * Callers can set a document URI through {@link #setData(Uri)} to indicate
+ * the initial location of documents navigator. System will do its best to
+ * initiate the navigator in the specified document if it's a folder, or
+ * the folder that contains the specified document if not.
+ * <p>
* Output: The URI representing the selected directory tree.
*
* @see DocumentsContract