Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit f1d55400 authored by Tomasz Mikolajewski's avatar Tomasz Mikolajewski
Browse files

Fix documentation for the Web Links API. 

Per API council feedback.

Test: None
Bug: 35812888
Change-Id: I18e7bf931a74772e315b359cf0d72d2129c0b90c
parent eaff891f

core/java/android/provider/DocumentsContract.java

+5 −2
Original line number Diff line number Diff line
@@ -1429,12 +1429,15 @@ public final class DocumentsContract { 
     * <p>Providers are required to show confirmation UI for all new permissions granted

     * for the linked document.

     *

     * <p>If list of recipients is known, then it should be passed in options as

     * <p>If list of recipients is known, then it can be passed in options as

     * {@link Intent#EXTRA_EMAIL} as either a string or list of strings. Note, that

     * this is just a hint for the provider, which can ignore the list. In either

     * case the provider is required to show a UI for letting the user confirm

     * any new permission grants.

     *

     * <p>Note, that the entire <code>options</code> bundle is send to the provider.

     * Make sure that you trust the provider before passing any sensitive information.

     *

     * <p>Since this API may show a UI, it cannot be called from background.

     *

     * <p>In order to obtain the Web Link use code like this:
@@ -1443,7 +1446,7 @@ public final class DocumentsContract { 
     *   IntentSender sender = DocumentsContract.createWebLinkIntent(<i>...</i>);

     *   if (sender != null) {

     *     startIntentSenderForResult(

     *         DocumentsContract.createWebLinkIntent(<i>...</i>),

     *         sender,

     *         WEB_LINK_REQUEST_CODE,

     *         null, 0, 0, 0, null);

     *   }