Update API doc on permanentlyDenied status

README.md

@@ -9,4 +9,3 @@ The Flutter permission_handler plugin is build following the federated plugin ar
 [2]: ./permission_handler/README.md
 [2]: ./permission_handler/README.md
 [3]: ./permission_handler_platform_interface
 [3]: ./permission_handler_platform_interface
 [4]: ./permission_handler_platform_interface/README.md
 [4]: ./permission_handler_platform_interface/README.md
-

permission_handler/CHANGELOG.md

+## 8.0.1
+
+* Updated API documentation for the `PermissionStatus.permanentlyDenied` status.
+
 ## 8.0.0+2
 ## 8.0.0+2
 
 
 * Fix broken Podfile link noted at `8.0.0`.
 * Fix broken Podfile link noted at `8.0.0`.

permission_handler/lib/permission_handler.dart

@@ -22,10 +22,6 @@ Future<bool> openAppSettings() => _handler.openAppSettings();
 /// Actions that can be executed on a permission.
 /// Actions that can be executed on a permission.
 extension PermissionActions on Permission {
 extension PermissionActions on Permission {
   /// The current status of this permission.
   /// The current status of this permission.
-  ///
-  /// The Android-only [PermissionStatus.permanentlyDenied] status will only be
-  /// calculated if the active context is an Activity. If it isn't,
-  /// [PermissionStatus.denied] will be returned.
   Future<PermissionStatus> get status => _handler.checkPermissionStatus(this);
   Future<PermissionStatus> get status => _handler.checkPermissionStatus(this);
 
 
   /// If you should show a rationale for requesting permission.
   /// If you should show a rationale for requesting permission.
@@ -64,14 +60,15 @@ extension PermissionCheckShortcuts on Permission {
   /// *Only supported on iOS.*
   /// *Only supported on iOS.*
   Future<bool> get isRestricted => status.isRestricted;
   Future<bool> get isRestricted => status.isRestricted;
 
 
-  ///User has authorized this application for limited photo library access.
+  /// User has authorized this application for limited photo library access.
   /// *Only supported on iOS.(iOS14+)*
   /// *Only supported on iOS.(iOS14+)*
   Future<bool> get isLimited => status.isLimited;
   Future<bool> get isLimited => status.isLimited;
 
 
-  /// If the user denied this permission and selected to never again show a
-  /// request for it. The user may still change the permission's status in the
-  /// device settings.
-  /// *Only supported on Android.*
+  /// Returns `true` when permissions are denied permanently.
+  ///
+  /// When permissions are denied permanently, no new permission dialog will
+  /// be showed to the user. Consuming Apps should redirect the user to the
+  /// App settings to change permissions.
   Future<bool> get isPermanentlyDenied => status.isPermanentlyDenied;
   Future<bool> get isPermanentlyDenied => status.isPermanentlyDenied;
 }
 }
 
 

permission_handler/pubspec.yaml

 name: permission_handler
 name: permission_handler
 description: Permission plugin for Flutter. This plugin provides a cross-platform (iOS, Android) API to request and check permissions.
 description: Permission plugin for Flutter. This plugin provides a cross-platform (iOS, Android) API to request and check permissions.
-version: 8.0.0+2
+version: 8.0.1
 homepage: https://github.com/baseflowit/flutter-permission-handler
 homepage: https://github.com/baseflowit/flutter-permission-handler
 
 
 flutter:
 flutter:
@@ -16,7 +16,7 @@ dependencies:
   flutter:
   flutter:
     sdk: flutter
     sdk: flutter
   meta: ^1.3.0
   meta: ^1.3.0
-  permission_handler_platform_interface: ^3.5.0
+  permission_handler_platform_interface: ^3.5.1
 
 
 dev_dependencies:
 dev_dependencies:
   flutter_test:
   flutter_test: