Index: modules/system/system.api.php
===================================================================
RCS file: /cvs/drupal/drupal/modules/system/system.api.php,v
retrieving revision 1.42
diff -u -r1.42 system.api.php
--- modules/system/system.api.php	18 Jun 2009 10:20:22 -0000	1.42
+++ modules/system/system.api.php	19 Jun 2009 13:37:37 -0000
@@ -554,17 +554,18 @@
  * can be selected on the user permissions page and used to grant or restrict
  * access to actions the module performs.
  *
- * @return
- *   An array of permissions where the permission name is the array key and the
- *   corresponding key value is an array of key/value pairs specifying
- *   the permission's title and description
- *
- * The permissions in the array do not need to be wrapped with the function t(),
- * since the string extractor takes care of extracting permission names defined in the perm hook for translation.
- *
  * Permissions are checked using user_access().
  *
  * For a detailed usage example, see page_example.module.
+ * 
+ * @return
+ *   An array of which permission names are the keys and their corresponding
+ *   values are descriptions of each permission.
+ *   The permission names (keys of the array) must not be wrapped with
+ *   the t() function, since the string extractor takes care of
+ *   extracting permission names defined in the perm hook for
+ *   translation. The permission descriptions (values of the array)
+ *   should be wrapped in the t() function so they can be translated.
  */
 function hook_perm() {
   return array(