Merge "Revert "Remove not needed contacts related perissions."" into mnc-dev

3 files changed, 55 insertions, 55 deletions

diff --git a/docs/html/about/versions/android-4.0.3.jd b/docs/html/about/versions/android-4.0.3.jd
index 4c2ccb9..5fa8547 100644
--- a/docs/html/about/versions/android-4.0.3.jd
+++ b/docs/html/about/versions/android-4.0.3.jd
@@ -78,19 +78,19 @@ can now sync that data with each of the user’s contacts, providing items in a
 stream along with photos for each.</p>
 
 <p>The database table that contains an individual contact’s social stream is
-defined by android.provider.ContactsContract.StreamItems, the Uri for
+defined by {@link android.provider.ContactsContract.StreamItems}, the Uri for
 which is nested within the {@link android.provider.ContactsContract.RawContacts}
 directory to which the stream items belong. Each social stream table includes
 several columns for metadata about each stream item, such as an icon
 representing the source (an avatar), a label for the item, the primary text
 content, comments about the item (such as responses from other people), and
 more. Photos associated with a stream are stored in another table, defined by
-android.provider.ContactsContract.StreamItemPhotos, which is available
-as a sub-directory of the android.provider.ContactsContract.StreamItems
+{@link android.provider.ContactsContract.StreamItemPhotos}, which is available
+as a sub-directory of the {@link android.provider.ContactsContract.StreamItems}
 Uri.</p>
 
-<p>See android.provider.ContactsContract.StreamItems and
-android.provider.ContactsContract.StreamItemPhotos for more information.</p>
+<p>See {@link android.provider.ContactsContract.StreamItems} and
+{@link android.provider.ContactsContract.StreamItemPhotos} for more information.</p>
 
 <p>To read or write social stream items for a contact, an application must
 request permission from the user by declaring <code>&lt;uses-permission
@@ -272,8 +272,8 @@ let you check and manage video stabilization for a {@link android.hardware.Camer
 
 <p>The following are new permissions:</p>
 <ul>
-<li>android.Manifest.permission#READ_SOCIAL_STREAM and
-android.Manifest.permission#WRITE_SOCIAL_STREAM: Allow a sync
+<li>{@link android.Manifest.permission#READ_SOCIAL_STREAM} and 
+{@link android.Manifest.permission#WRITE_SOCIAL_STREAM}: Allow a sync
 adapter to read and write social stream data to a contact in the shared
 Contacts Provider.</li>
 </ul>
diff --git a/docs/html/about/versions/android-4.0.jd b/docs/html/about/versions/android-4.0.jd
index cc1d1c7..6c4ccb4 100644
--- a/docs/html/about/versions/android-4.0.jd
+++ b/docs/html/about/versions/android-4.0.jd
@@ -108,9 +108,9 @@ android.provider.ContactsContract.RawContacts} Uri; instead, you must add a prof
 the table at {@link android.provider.ContactsContract.Profile#CONTENT_RAW_CONTACTS_URI}. Raw
 contacts in this table are then aggregated into the single user-visible profile labeled "Me".</p>
 
-<p>Adding a new raw contact for the profile requires the
-android.Manifest.permission#WRITE_PROFILE permission. Likewise, in order to read from the profile
-table, you must request the android.Manifest.permission#READ_PROFILE permission. However,
+<p>Adding a new raw contact for the profile requires the {@link
+android.Manifest.permission#WRITE_PROFILE} permission. Likewise, in order to read from the profile
+table, you must request the {@link android.Manifest.permission#READ_PROFILE} permission. However,
 most apps should not need to read the user profile, even when contributing data to the
 profile. Reading the user profile is a sensitive permission and you should expect users to be
 skeptical of apps that request it.</p>
@@ -1638,9 +1638,9 @@ messages to the device.</li>
 android.service.textservice.SpellCheckerService} must require this permission for itself.</li>
 <li>{@link android.Manifest.permission#BIND_VPN_SERVICE}: A service that implements {@link
 android.net.VpnService} must require this permission for itself.</li>
-<li>android.Manifest.permission#READ_PROFILE: Provides read access to the {@link
+<li>{@link android.Manifest.permission#READ_PROFILE}: Provides read access to the {@link
 android.provider.ContactsContract.Profile} provider.</li>
-<li>android.Manifest.permission#WRITE_PROFILE: Provides write access to the {@link
+<li>{@link android.Manifest.permission#WRITE_PROFILE}: Provides write access to the {@link
 android.provider.ContactsContract.Profile} provider.</li>
 </ul>
 
diff --git a/docs/html/guide/topics/providers/contacts-provider.jd b/docs/html/guide/topics/providers/contacts-provider.jd
index 2b14558..e3b998a 100644
--- a/docs/html/guide/topics/providers/contacts-provider.jd
+++ b/docs/html/guide/topics/providers/contacts-provider.jd
@@ -57,7 +57,7 @@ page.title=Contacts Provider
     <li>{@link android.provider.ContactsContract.Contacts}</li>
     <li>{@link android.provider.ContactsContract.RawContacts}</li>
     <li>{@link android.provider.ContactsContract.Data}</li>
-    <li>android.provider.ContactsContract.StreamItems</li>
+    <li>{@link android.provider.ContactsContract.StreamItems}</li>
 </ol>
 <h2>Related Samples</h2>
 <ol>
@@ -606,13 +606,13 @@ page.title=Contacts Provider
     Access to the user profile requires special permissions. In addition to the
     {@link android.Manifest.permission#READ_CONTACTS} and
     {@link android.Manifest.permission#WRITE_CONTACTS} permissions needed to read and write, access
-    to the user profile requires the android.Manifest.permission#READ_PROFILE and
-    android.Manifest.permission#WRITE_PROFILE permissions for read and write access,
+    to the user profile requires the {@link android.Manifest.permission#READ_PROFILE} and
+    {@link android.Manifest.permission#WRITE_PROFILE} permissions for read and write access,
     respectively.
 </p>
 <p>
     Remember that you should consider a user's profile to be sensitive. The permission
-    android.Manifest.permission#READ_PROFILE allows you to access the device user's
+    {@link android.Manifest.permission#READ_PROFILE} allows you to access the device user's
     personally-identifying data. Make sure to tell the user why
     you need user profile access permissions in the description of your application.
 </p>
@@ -1826,8 +1826,8 @@ child elements that provide specific data to the
     </dl>
 <h2 id="SocialStream">Social Stream Data</h2>
 <p>
-    The android.provider.ContactsContract.StreamItems and
-    android.provider.ContactsContract.StreamItemPhotos tables
+    The {@link android.provider.ContactsContract.StreamItems} and
+    {@link android.provider.ContactsContract.StreamItemPhotos} tables
     manage incoming data from social networks. You can write a sync adapter that adds stream data
     from your own network to these tables, or you can read stream data from these tables and
     display it in your own application, or both. With these features, your social networking
@@ -1836,7 +1836,7 @@ child elements that provide specific data to the
 <h3 id="StreamText">Social stream text</h3>
 <p>
     Stream items are always associated with a raw contact. The
-    android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID links to the
+    {@link android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID} links to the
     <code>_ID</code> value for the raw contact. The account type and account name of the raw
     contact are also stored in the stream item row.
 </p>
@@ -1845,14 +1845,14 @@ child elements that provide specific data to the
 </p>
 <dl>
     <dt>
-        android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_TYPE
+        {@link android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_TYPE}
     </dt>
     <dd>
         <strong>Required.</strong> The user's account type for the raw contact associated with this
         stream item. Remember to set this value when you insert a stream item.
     </dd>
     <dt>
-        android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_NAME
+        {@link android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_NAME}
     </dt>
     <dd>
         <strong>Required.</strong> The user's account name for the raw contact associated with this
@@ -1866,30 +1866,30 @@ child elements that provide specific data to the
         insert a stream item:
         <ul>
             <li>
-                android.provider.ContactsContract.StreamItemsColumns#CONTACT_ID: The
-                android.provider.BaseColumns#_ID value of the contact that this stream
+                {@link android.provider.ContactsContract.StreamItemsColumns#CONTACT_ID}: The
+                {@link android.provider.BaseColumns#_ID} value of the contact that this stream
                 item is associated with.
             </li>
             <li>
-                android.provider.ContactsContract.StreamItemsColumns#CONTACT_LOOKUP_KEY: The
-                android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY value of the
+                {@link android.provider.ContactsContract.StreamItemsColumns#CONTACT_LOOKUP_KEY}: The
+                {@link android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} value of the
                 contact this stream item is associated with.
             </li>
             <li>
-                android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID: The
-                android.provider.BaseColumns#_ID value of the raw contact that this stream
+                {@link android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID}: The
+                {@link android.provider.BaseColumns#_ID} value of the raw contact that this stream
                 item is associated with.
             </li>
         </ul>
     </dd>
     <dt>
-        android.provider.ContactsContract.StreamItemsColumns#COMMENTS
+        {@link android.provider.ContactsContract.StreamItemsColumns#COMMENTS}
     </dt>
     <dd>
         Optional. Stores summary information that you can display at the beginning of a stream item.
     </dd>
     <dt>
-        android.provider.ContactsContract.StreamItemsColumns#TEXT
+        {@link android.provider.ContactsContract.StreamItemsColumns#TEXT}
     </dt>
     <dd>
         The text of the stream item, either the content that was posted by the source of the item,
@@ -1899,7 +1899,7 @@ child elements that provide specific data to the
         ellipsize long content, but it will try to avoid breaking tags.
     </dd>
     <dt>
-        android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP
+        {@link android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP}
     </dt>
     <dd>
         A text string containing the time the stream item was inserted or updated, in the form
@@ -1910,42 +1910,42 @@ child elements that provide specific data to the
 </dl>
 <p>
     To display identifying information for your stream items, use the
-    android.provider.ContactsContract.StreamItemsColumns#RES_ICON,
-    android.provider.ContactsContract.StreamItemsColumns#RES_LABEL, and
-    android.provider.ContactsContract.StreamItemsColumns#RES_PACKAGE to link to resources
+    {@link android.provider.ContactsContract.StreamItemsColumns#RES_ICON},
+    {@link android.provider.ContactsContract.StreamItemsColumns#RES_LABEL}, and
+    {@link android.provider.ContactsContract.StreamItemsColumns#RES_PACKAGE} to link to resources
     in your application.
 </p>
 <p>
-    The android.provider.ContactsContract.StreamItems table also contains the columns
-    android.provider.ContactsContract.StreamItemsColumns#SYNC1 through
-    android.provider.ContactsContract.StreamItemsColumns#SYNC4 for the exclusive use of
+    The {@link android.provider.ContactsContract.StreamItems} table also contains the columns
+    {@link android.provider.ContactsContract.StreamItemsColumns#SYNC1} through
+    {@link android.provider.ContactsContract.StreamItemsColumns#SYNC4} for the exclusive use of
     sync adapters.
 </p>
 <h3 id="StreamPhotos">Social stream photos</h3>
 <p>
-   The android.provider.ContactsContract.StreamItemPhotos table stores photos associated
+   The {@link android.provider.ContactsContract.StreamItemPhotos} table stores photos associated
    with a stream item. The table's
-   android.provider.ContactsContract.StreamItemPhotosColumns#STREAM_ITEM_ID column
+   {@link android.provider.ContactsContract.StreamItemPhotosColumns#STREAM_ITEM_ID} column
    links to values in the {@link android.provider.BaseColumns#_ID} column of
-   android.provider.ContactsContract.StreamItems table. Photo references are stored in the
+   {@link android.provider.ContactsContract.StreamItems} table. Photo references are stored in the
    table in these columns:
 </p>
 <dl>
     <dt>
-        android.provider.ContactsContract.StreamItemPhotos#PHOTO column (a BLOB).
+        {@link android.provider.ContactsContract.StreamItemPhotos#PHOTO} column (a BLOB).
     </dt>
     <dd>
         A binary representation of the photo, resized by the provider for storage and display.
         This column is available for backwards compatibility with previous versions of the Contacts
         Provider that used it for storing photos. However, in the current version
         you should not use this column to store photos. Instead, use
-        either android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID or
-        android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI (both of
+        either {@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} or
+        {@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI} (both of
         which are described in the following points) to store photos in a file. This column now
         contains a thumbnail of the photo, which is available for reading.
     </dd>
     <dt>
-        android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID
+        {@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID}
     </dt>
     <dd>
         A numeric identifier of a photo for a raw contact. Append this value to the constant
@@ -1955,7 +1955,7 @@ child elements that provide specific data to the
         openAssetFileDescriptor()} to get a handle to the photo file.
     </dd>
     <dt>
-        android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI
+        {@link android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI}
     </dt>
     <dd>
         A content URI pointing directly to the photo file for the photo represented by this row.
@@ -1970,27 +1970,27 @@ child elements that provide specific data to the
     <ul>
         <li>
             These tables require additional access permissions. To read from them, your application
-            must have the permission android.Manifest.permission#READ_SOCIAL_STREAM. To
+            must have the permission {@link android.Manifest.permission#READ_SOCIAL_STREAM}. To
             modify them, your application must have the permission
-            android.Manifest.permission#WRITE_SOCIAL_STREAM.
+            {@link android.Manifest.permission#WRITE_SOCIAL_STREAM}.
         </li>
         <li>
-            For the android.provider.ContactsContract.StreamItems table, the number of rows
+            For the {@link android.provider.ContactsContract.StreamItems} table, the number of rows
             stored for each raw contact is limited. Once this limit is reached,
             the Contacts Provider makes space for new stream item rows by automatically deleting
             the rows having the oldest
-            android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP. To get the
+            {@link android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP}. To get the
             limit, issue a query to the content URI
-            android.provider.ContactsContract.StreamItems#CONTENT_LIMIT_URI. You can leave
+            {@link android.provider.ContactsContract.StreamItems#CONTENT_LIMIT_URI}. You can leave
             all the arguments other than the content URI set to <code>null</code>. The query
             returns a Cursor containing a single row, with the single column
-            android.provider.ContactsContract.StreamItems#MAX_ITEMS.
+            {@link android.provider.ContactsContract.StreamItems#MAX_ITEMS}.
         </li>
     </ul>
 
 <p>
-    The class android.provider.ContactsContract.StreamItems.StreamItemPhotos defines a
-    sub-table of android.provider.ContactsContract.StreamItemPhotos containing the photo
+    The class {@link android.provider.ContactsContract.StreamItems.StreamItemPhotos} defines a
+    sub-table of {@link android.provider.ContactsContract.StreamItemPhotos} containing the photo
     rows for a single stream item.
 </p>
 <h3 id="SocialStreamInteraction">Social stream interactions</h3>
@@ -2003,8 +2003,8 @@ child elements that provide specific data to the
         <li>
             By syncing your social networking service to the Contacts Provider with a sync
             adapter, you can retrieve recent activity for a user's contacts and store it in
-            the android.provider.ContactsContract.StreamItems and
-            android.provider.ContactsContract.StreamItemPhotos tables for later use.
+            the {@link android.provider.ContactsContract.StreamItems} and
+            {@link android.provider.ContactsContract.StreamItemPhotos} tables for later use.
         </li>
         <li>
             Besides regular synchronization, you can trigger your sync adapter to retrieve
@@ -2356,6 +2356,6 @@ child elements that provide specific data to the
 </p>
 <p>
     Social stream data for a person may also include photos. These are stored in the
-    android.provider.ContactsContract.StreamItemPhotos table, which is described in more
+    {@link android.provider.ContactsContract.StreamItemPhotos} table, which is described in more
     detail in the section <a href="#StreamPhotos">Social stream photos</a>.
 </p>