Index: modules/user/user.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/user/user.module,v
retrieving revision 1.1006
diff -u -p -r1.1006 user.module
--- modules/user/user.module	2 Jul 2009 15:07:37 -0000	1.1006
+++ modules/user/user.module	5 Jul 2009 00:48:43 -0000
@@ -2351,11 +2351,12 @@ function user_help($path, $arg) {
     case 'admin/user/permissions':
       return '<p>' . t('Permissions let you control what users can do and see on your site. You can define a specific set of permissions for each role. (See the <a href="@role">Roles</a> page to create a role). Two important roles to consider are Authenticated Users and Administrators. Any permissions granted to the Authenticated Users role will be given to any user who can log into your site.  You can make any role the Administrator role for the site, meaning this will be granted all new permissions automatically. You can do this on the <a href="@settings">User Settings</a> page. You should be careful to ensure that only trusted users are given this access and level of control of your site.', array('@role' => url('admin/user/roles'), '@settings' => url('admin/settings/user'))) . '</p>';
     case 'admin/user/roles':
-      return t('<p>Roles allow you to fine tune the security and administration of Drupal. A role defines a group of users that have certain privileges as defined in <a href="@permissions">user permissions</a>. Examples of roles include: anonymous user, authenticated user, moderator, administrator and so on. In this area you will define the <em>role names</em> of the various roles. To delete a role choose "edit".</p><p>By default, Drupal comes with two user roles:</p>
-      <ul>
-      <li>Anonymous user: this role is used for users that don\'t have a user account or that are not authenticated.</li>
-      <li>Authenticated user: this role is automatically granted to all logged in users.</li>
-      </ul>', array('@permissions' => url('admin/user/permissions')));
+      $output = '<p>' . t('Roles allow you to define user groups, each with its own set of <a href="@permissions">permissions</a>. Create additional roles using this page, or edit the names of existing roles (to delete a role, choose "edit").', array('@permissions' => url('admin/user/permissions'))) . '</p>';
+      $output .= '<p>' . t('By default, Drupal comes with three user roles:') . '</p>';
+      $output .= '<ul><li>' . t('<em>Anonymous user:</em> this role is used for users without an account or who are not logged in.') . '</li>';
+      $output .= '<li>' . t('<em>Authenticated user:</em> this role is automatically granted to all logged in users.') . '</li>';
+      $output .= '<li>' . t('<em>Administrator role:</em> this role is automatically granted all permissions, and should only include your most trusted users.') . '</li></ul>';
+      return $output;
     case 'admin/user/search':
       return '<p>' . t('Enter a simple pattern ("*" may be used as a wildcard match) to search for a username or e-mail address. For example, one may search for "br" and Drupal might return "brian", "brad", and "brenda@example.com".') . '</p>';
   }