Version 0.3.1

Author: samtstern

README.md

@@ -9,7 +9,7 @@ EasyPermissions is installed by adding the following dependency to your `build.g
 
 ```groovy
 dependencies {
-    compile 'pub.devrel:easypermissions:0.3.0'
+    compile 'pub.devrel:easypermissions:0.3.1'
 }
 ```
 

build.gradle

@@ -29,11 +29,11 @@ ext {
 
     mavenGroup = 'pub.devrel'
     mavenArtifactId = 'easypermissions'
-    mavenVersion = '0.3.0'
+    mavenVersion = '0.3.1'
 
     bintrayOrg = 'easygoogle'
 
-    support_library_version = '25.2.0'
+    support_library_version = '25.3.1'
 
     buildTools = '25.0.2'
     compileSdk = 25

easypermissions/src/main/java/pub/devrel/easypermissions/EasyPermissions.java

@@ -40,6 +40,10 @@
  */
 public class EasyPermissions {
 
+    /**
+     * Callback interface to receive the results of {@code EasyPermissions.requestPermissions()}
+     * calls.
+     */
     public interface PermissionCallbacks extends ActivityCompat.OnRequestPermissionsResultCallback {
 
         void onPermissionsGranted(int requestCode, List<String> perms);
@@ -434,6 +438,12 @@ public static boolean somePermissionDenied(@NonNull android.app.Fragment fragmen
         return shouldShowRationale(fragment, perms);
     }
 
+    /**
+     * Determine if rationale should be shown before asking for the given permission.
+     * @param object the Fragment or Activity.
+     * @param perm the permission.
+     * @return {@code true} if rationale should be shown, {@code false} otherwise.
+     */
     private static boolean shouldShowRequestPermissionRationale(@NonNull Object object,
                                                                 @NonNull String perm) {
         if (object instanceof Activity) {
@@ -467,6 +477,12 @@ private static void showRationaleDialogFragment(@NonNull android.app.FragmentMan
                 .show(fragmentManager, DIALOG_TAG);
     }
 
+    /**
+     * Find all methods annotated with {@link AfterPermissionGranted} on a given object with the
+     * correc requestCode argument.
+     * @param object the object with annotated methods.
+     * @param requestCode the requestCode passed to the annotation.
+     */
     private static void runAnnotatedMethods(@NonNull Object object, int requestCode) {
         Class clazz = object.getClass();
         if (isUsingAndroidAnnotations(object)) {
@@ -504,6 +520,9 @@ private static void runAnnotatedMethods(@NonNull Object object, int requestCode)
         }
     }
 
+    /**
+     * Determine if the project is using the AndroidAnnoations library.
+     */
     private static boolean isUsingAndroidAnnotations(@NonNull Object object) {
         if (!object.getClass().getSimpleName().endsWith("_")) {
             return false;