diff --git a/core/java/android/provider/ContactsContract.java b/core/java/android/provider/ContactsContract.java index 81e1eb99336b1..af3a16c987e68 100644 --- a/core/java/android/provider/ContactsContract.java +++ b/core/java/android/provider/ContactsContract.java @@ -870,8 +870,8 @@ public final class ContactsContract { protected interface ContactOptionsColumns { /** * The number of times a contact has been contacted. - *

Caution: As of January 7, 2019, this field is obsolete. For - * more information, see the + *

Caution: If you publish your app to the Google Play Store, + * this field is obsolete, regardless of Android version. For more information, see the * Contacts Provider * page.

*

Type: INTEGER

@@ -885,8 +885,8 @@ public final class ContactsContract { /** * The last time a contact was contacted. - *

Caution: As of January 7, 2019, this field is obsolete. For - * more information, see the + *

Caution: If you publish your app to the Google Play Store, + * this field is obsolete, regardless of Android version. For more information, see the * Contacts Provider * page.

*

Type: INTEGER

@@ -1691,10 +1691,10 @@ public final class ContactsContract { * TIMES_CONTACTED field is incremented by 1 and the LAST_TIME_CONTACTED * field is populated with the current system time. * - *

Caution: As of January 7, 2019, this method is obsolete. For - * more information, see the + *

Caution: If you publish your app to the Google Play Store, + * this field is obsolete, regardless of Android version. For more information, see the * Contacts Provider - * page. + * page.

* * @param resolver the ContentResolver to use * @param contactId the person who was contacted @@ -1730,8 +1730,8 @@ public final class ContactsContract { * Frequent contacts are no longer included in the result as of * Android version {@link android.os.Build.VERSION_CODES#Q}. * - *

Caution: As of January 7, 2019, this field no longer sorts - * results based on contacts frequency. For more information, see the + *

Caution: If you publish your app to the Google Play Store, this + * field doesn't sort results based on contacts frequency. For more information, see the * Contacts Provider * page. */ @@ -1745,8 +1745,8 @@ public final class ContactsContract { * Android version {@link android.os.Build.VERSION_CODES#Q}. * This URI always returns an empty cursor. * - *

Caution: As of January 7, 2019, this field no longer sorts - * results based on contacts frequency. For more information, see the + *

Caution: If you publish your app to the Google Play Store, this + * field doesn't sort results based on contacts frequency. For more information, see the * Contacts Provider * page. */ @@ -1760,8 +1760,8 @@ public final class ContactsContract { * various parts of the contact name. The filter argument should be passed * as an additional path segment after this URI. * - *

Caution: As of January 7, 2019, this field no longer sorts - * results based on contacts frequency. For more information, see the + *

Caution: If you publish your app to the Google Play Store, this + * field doesn't sort results based on contacts frequency. For more information, see the * Contacts Provider * page. */ @@ -4292,10 +4292,10 @@ public final class ContactsContract { * Android version {@link android.os.Build.VERSION_CODES#Q}. * This column always contains 0. * - *

Caution: As of January 7, 2019, this field is obsolete. - * For more information, see the + *

Caution: If you publish your app to the Google Play Store, + * this field is obsolete, regardless of Android version. For more information, see the * Contacts Provider - * page. + * page.

*/ @Deprecated public static final String LAST_TIME_USED = "last_time_used"; @@ -4306,10 +4306,10 @@ public final class ContactsContract { * Android version {@link android.os.Build.VERSION_CODES#Q}. * This column always contains 0. * - *

Caution: As of January 7, 2019, this field is obsolete. - * For more information, see the + *

Caution: If you publish your app to the Google Play Store, + * this field is obsolete, regardless of Android version. For more information, see the * Contacts Provider - * page. + * page.

*/ @Deprecated public static final String TIMES_USED = "times_used"; @@ -5259,8 +5259,8 @@ public final class ContactsContract { /** * The content:// style URI for this table. * - *

Caution: As of January 7, 2019, this field no longer - * sorts results based on contacts frequency. For more information, see the + *

Caution: If you publish your app to the Google Play Store, this + * field doesn't sort results based on contacts frequency. For more information, see the * Contacts Provider * page. * @@ -5277,8 +5277,8 @@ public final class ContactsContract { /** *

URI used for the "enterprise caller-id".

* - *

Caution: As of January 7, 2019, this field no longer - * sorts results based on contacts frequency. For more information, see the + *

Caution: If you publish your app to the Google Play Store, this + * field doesn't sort results based on contacts frequency. For more information, see the * Contacts Provider * page. * @@ -6079,8 +6079,8 @@ public final class ContactsContract { * to display names as well as phone numbers. The filter argument should be passed * as an additional path segment after this URI. * - *

Caution: As of January 7, 2019, this field no longer - * sorts results based on contacts frequency. For more information, see the + *

Caution: This field deosn't sort results based on contacts + * frequency. For more information, see the * Contacts Provider * page. */ @@ -6092,8 +6092,9 @@ public final class ContactsContract { * same columns. This URI requires {@link ContactsContract#DIRECTORY_PARAM_KEY} in * parameters, otherwise it will throw IllegalArgumentException. * - *

Caution: As of January 7, 2019, this field no longer sorts - * results based on contacts frequency. For more information, see the + *

Caution: If you publish your app to the Google Play Store, + * this field doesn't sort results based on contacts frequency. For more information, + * see the * Contacts Provider * page. */ @@ -6360,8 +6361,9 @@ public final class ContactsContract { * as an additional path segment after this URI. *

* - *

Caution: As of January 7, 2019, this field no longer sorts - * results based on contacts frequency. For more information, see the + *

Caution: If you publish your app to the Google Play Store, + * this field doesn't sort results based on contacts frequency. For more information, + * see the * Contacts Provider * page.

* @@ -6383,8 +6385,9 @@ public final class ContactsContract { * same columns. This URI requires {@link ContactsContract#DIRECTORY_PARAM_KEY} in * parameters, otherwise it will throw IllegalArgumentException. * - *

Caution: As of January 7, 2019, this field no longer - * sorts results based on contacts frequency. For more information, see the + *

Caution: If you publish your app to the Google Play Store, + * this field doesn't sort results based on contacts frequency. For more information, + * see the * Contacts Provider * page. */ @@ -7602,8 +7605,8 @@ public final class ContactsContract { *

Similar to {@link Phone#CONTENT_FILTER_URI}, but allows users to filter callable * data. * - *

Caution: As of January 7, 2019, this field no longer - * sorts results based on contacts frequency. For more information, see the + *

Caution: This field no longer sorts results based on + * contacts frequency. For more information, see the * Contacts Provider * page. */ @@ -7615,8 +7618,9 @@ public final class ContactsContract { * callable data. This URI requires {@link ContactsContract#DIRECTORY_PARAM_KEY} in * parameters, otherwise it will throw IllegalArgumentException. * - *

Caution: As of January 7, 2019, this field no longer - * sorts results based on contacts frequency. For more information, see the + *

Caution: If you publish your app to the Google Play Store, + * this field doesn't sort results based on contacts frequency. For more information, + * see the * Contacts Provider * page.

*/ @@ -7646,8 +7650,9 @@ public final class ContactsContract { *

The content:// style URI for these data items, which allows for a query parameter * to be appended onto the end to filter for data items matching the query. * - *

Caution: As of January 7, 2019, this field no longer - * sorts results based on contacts frequency. For more information, see the + *

Caution: If you publish your app to the Google Play Store, + * this field doesn't sort results based on contacts frequency. For more information, + * see the * Contacts Provider * page. */ @@ -8298,15 +8303,14 @@ public final class ContactsContract { } /** - *

Caution: As of January 7, 2019, this class is obsolete. For - * more information, see the - * Contacts Provider - * page. - *

*

* API allowing applications to send usage information for each {@link Data} row to the * Contacts Provider. Applications can also clear all usage information. *

+ *

Caution: If you publish your app to the Google Play Store, + * this field is obsolete, regardless of Android version. For more information, see the + * Contacts Provider + * page.

*

* With the feedback, Contacts Provider may return more contextually appropriate results for * Data listing, typically supplied with