From 869e68504e5614417e8d5013b00c0d6b1ea49418 Mon Sep 17 00:00:00 2001 From: Manuel Beck Date: Wed, 6 May 2026 12:25:08 +0200 Subject: [PATCH] doc: improve documentation - Forgot to commit everything --- .../src/org/apache/cordova/CordovaPlugin.java | 22 ++++++++++++------- 1 file changed, 14 insertions(+), 8 deletions(-) diff --git a/framework/src/org/apache/cordova/CordovaPlugin.java b/framework/src/org/apache/cordova/CordovaPlugin.java index 790f5034..ff5cad4c 100644 --- a/framework/src/org/apache/cordova/CordovaPlugin.java +++ b/framework/src/org/apache/cordova/CordovaPlugin.java @@ -416,11 +416,14 @@ public class CordovaPlugin { } /** - * Forwarded system call to {@link CordovaActivity#onRequestPermissionsResult(int, String[], int[])} - * and from there to the plugin that requested permissions, when the user granted them, denied them, - * or when the request was interrupted. - * This is a legacy method that will be called if a plugin overrides it, - * but new plugins should override {@link #onRequestPermissionsResult} instead. + * Forwarded system call to the plugin when the user grants permissions, + * denies them or the request was interrupted. + * This is a legacy method and should not be used anymore. + * Instead {@link #onRequestPermissionsResult} should be used. + * + * Note: The system calls {@link CordovaActivity#onRequestPermissionsResult(int, String[], int[])}, + * which calls {@link CordovaInterfaceImpl#onRequestPermissionsResult(int, String[], int[])}, + * and finally this method. * * @param requestCode * @param permissions @@ -434,9 +437,12 @@ public class CordovaPlugin { } /** - * Forwarded system call to {@link CordovaActivity#onRequestPermissionsResult(int, String[], int[])} - * and from there to the plugin that requested permissions, when the user granted them, denied them, - * or when the request was interrupted. + * Forwarded system call to the plugin when the user grants permissions, + * denies them or the request was interrupted. + * + * Note: The system calls {@link CordovaActivity#onRequestPermissionsResult(int, String[], int[])}, + * which calls {@link CordovaInterfaceImpl#onRequestPermissionsResult(int, String[], int[])}, + * and finally this method. * * @param requestCode * @param permissions