From 95fd74c1f7d666446e60602a08ebf2a17edbdbf7 Mon Sep 17 00:00:00 2001
From: Abhijith Shastry <ashastry@google.com>
Date: Wed, 18 May 2016 16:20:10 -0700
Subject: [PATCH] Update BlockedNumberContract javadocs.

Include @return for all public methods.

BUG: 28842525
Change-Id: Ie0fddee1d889f188a77c45d8bdbf78ea9fe323ba
---
 core/java/android/provider/BlockedNumberContract.java | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/core/java/android/provider/BlockedNumberContract.java b/core/java/android/provider/BlockedNumberContract.java
index 92a22d101193a..fb11d00cec463 100644
--- a/core/java/android/provider/BlockedNumberContract.java
+++ b/core/java/android/provider/BlockedNumberContract.java
@@ -237,6 +237,8 @@ public class BlockedNumberContract {
      *
      * <p> Note that if the {@link #canCurrentUserBlockNumbers} is {@code false} for the user
      * context {@code context}, this method will throw a {@link SecurityException}.
+     *
+     * @return {@code true} if the {@code phoneNumber} is blocked.
      */
     @WorkerThread
     public static boolean isBlocked(Context context, String phoneNumber) {
@@ -248,8 +250,6 @@ public class BlockedNumberContract {
     /**
      * Unblocks the {@code phoneNumber} if it is blocked.
      *
-     * <p> Returns the number of rows deleted in the blocked number provider as a result of unblock.
-     *
      * <p> This deletes all rows where the {@code phoneNumber} matches the
      * {@link BlockedNumbers#COLUMN_ORIGINAL_NUMBER} column or the E164 representation of the
      * {@code phoneNumber} matches the {@link BlockedNumbers#COLUMN_E164_NUMBER} column.
@@ -261,6 +261,8 @@ public class BlockedNumberContract {
      *
      * <p> Note that if the {@link #canCurrentUserBlockNumbers} is {@code false} for the user
      * context {@code context}, this method will throw a {@link SecurityException}.
+     *
+     * @return the number of rows deleted in the blocked number provider as a result of unblock.
      */
     @WorkerThread
     public static int unblock(Context context, String phoneNumber) {
@@ -270,8 +272,10 @@ public class BlockedNumberContract {
     }
 
     /**
-     * Returns {@code true} if blocking numbers is supported for the current user.
+     * Checks if blocking numbers is supported for the current user.
      * <p> Typically, blocking numbers is only supported for one user at a time.
+     *
+     * @return {@code true} if the current user can block numbers.
      */
     public static boolean canCurrentUserBlockNumbers(Context context) {
         final Bundle res = context.getContentResolver().call(