### Eclipse Workspace Patch 1.0
#P Drupal-7-HEAD
Index: modules/user/user.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/user/user.module,v
retrieving revision 1.1204
diff -u -r1.1204 user.module
--- modules/user/user.module	24 Sep 2010 00:37:45 -0000	1.1204
+++ modules/user/user.module	30 Sep 2010 07:12:38 -0000
@@ -2810,19 +2810,23 @@
  *
  * This function may be used to grant and revoke multiple permissions at once.
  * For example, when a form exposes checkboxes to configure permissions for a
- * role, the submitted values may be directly passed on in a form submit
- * handler.
+ * role, the form submit handler may directly pass the submitted values on to 
+ * user_role_change_permissions.
  *
  * @param $rid
  *   The ID of a user role to alter.
  * @param $permissions
- *   An array of permissions, where the key holds the permission name and the
- *   value is an integer or boolean that determines whether to grant or revoke
- *   the permission:
+ *   An associative array, where the key holds the permission name and the
+ *   value determines whether to grant or revoke that permission. Any value that
+ *   evaluates to true will cause the permission to granted. Values that
+ *   evaluate to false will cause the permission to be revoked.
  *   @code
  *     array(
- *       'administer nodes' => 0,
- *       'access user profiles' => 1,
+ *       'administer nodes' => 0,                // Revoke 'administer nodes'
+ *       'administer blocks' => false,           // Revoke 'administer blocks'
+ *       'access user profiles' => 1,            // Grant 'access user profiles'
+ *       'access comments' => 'access comments', // Grant 'access comments'
+ *       'access content' => -1,                 // Grant 'access content'
  *     )
  *   @endcode
  *   Existing permissions are not changed, unless specified in $permissions.