Index: modules/system/system.api.php
===================================================================
RCS file: /cvs/drupal/drupal/modules/system/system.api.php,v
retrieving revision 1.228
diff -u -r1.228 system.api.php
--- modules/system/system.api.php	9 Feb 2011 02:26:04 -0000	1.228
+++ modules/system/system.api.php	9 Feb 2011 23:12:50 -0000
@@ -1912,6 +1912,9 @@
  *     warning message defined in user_admin_permissions() will be associated
  *     with the permission and displayed with it on the permission
  *     administration page. Defaults to FALSE.
+ *   - warning: (optional) A translated warning message to display on the
+ *     permission administration page. This warning overrides the automatic
+ *     warning generated by 'restrict access' being set to TRUE.
  */
 function hook_permission() {
   return array(