Index: modules/profile/profile.admin.inc
===================================================================
RCS file: /cvs/drupal/drupal/modules/profile/profile.admin.inc,v
retrieving revision 1.38
diff -u -r1.38 profile.admin.inc
--- profile.admin.inc	13 Jan 2010 06:44:31 -0000	1.38
+++ profile.admin.inc	24 Jan 2010 01:26:23 -0000
@@ -219,20 +219,20 @@
     '#title' => t('Category'),
     '#default_value' => $edit['category'],
     '#autocomplete_path' => 'admin/config/people/profile/autocomplete',
-    '#description' => t('The category the new field should be part of. Categories are used to group fields logically. An example category is "Personal information".'),
+    '#description' => t('The <abbr title="If the category you enter here does not already exist, it will be created automatically after you save this new field.">category</abbr> the new field should be part of. Categories are used to group fields logically with other fields. An example category is <em>Personal information</em>.'),
     '#required' => TRUE,
   );
   $form['fields']['title'] = array('#type' => 'textfield',
     '#title' => t('Title'),
     '#default_value' => $edit['title'],
-    '#description' => t('The title of the new field. The title will be shown to the user. An example title is "Favorite color".'),
+    '#description' => t('The title of this new field as it will be shown to the user. An example title is <em>Favorite color</em>.'),
     '#required' => TRUE,
   );
   $form['fields']['name'] = array('#type' => 'textfield',
-    '#title' => t('Form name'),
+    '#title' => t('Field name'),
     '#default_value' => $edit['name'],
-    '#description' => t('The name of the field. The form name is not shown to the user but used internally in the HTML code and URLs.
-Unless you know what you are doing, it is highly recommended that you prefix the form name with <code>profile_</code> to avoid name clashes with other fields. Spaces or any other special characters except dash (-) and underscore (_) are not allowed. An example name is "profile_favorite_color" or perhaps just "profile_color".'),
+    '#description' => t('The name of this profile field. The user will not see this name, but it will be used <abbr title="\'Internally\' = \'By the system\'">internally</abbr> to create the site\'s HTML code and URLs.
+Unless you know what you are doing, it is <em>highly</em> recommended that you prefix the field name with <code>profile_</code> to avoid name clashes with other fields. Spaces or any other special characters except dash (-) and underscore (_) are not allowed. An <abbr title="Notice that both examples are prefixed with \'profile_\'">example</abbr> name for this field is <em>profile_favorite_color</em> or perhaps just <em>profile_color</em>.'),
     '#required' => TRUE,
   );
   $form['fields']['explanation'] = array('#type' => 'textarea',
@@ -256,7 +256,7 @@
     $form['fields']['page'] = array('#type' => 'textfield',
       '#title' => t('Page title'),
       '#default_value' => $edit['page'],
-      '#description' => t('To enable browsing this field by value, enter a title for the resulting page. The word <code>%value</code> will be substituted with the corresponding value. An example page title is "People whose favorite color is %value" . This is only applicable for a public field.'),
+      '#description' => t('To make this field a unique "characteristic" of each user\'s profile, enter a page title that other users will see when they click on the characteristic. The word <code>%value</code> (wherever you type it here) will be substituted with the actual value chosen by the user. For example, if this field asked the user about their favorite color, and the user\'s answer was <em>red</em>, whenever anyone was browsing user profiles whose favorite color was <em>red</em> then the title of the page they would see might be <strong>People whose favorite color is <em>red</em></strong>, in which case you would enter <code>People whose favorite color is %value</code> for the "Page title" in the box above.<br/>Note: This only applies to <em>public</em> fields.'),
     );
   }
   elseif ($type == 'checkbox') {
@@ -272,16 +272,16 @@
     '#description' => t('The weights define the order in which the form fields are shown. Lighter fields "float up" towards the top of the category.'),
   );
   $form['fields']['autocomplete'] = array('#type' => 'checkbox',
-    '#title' => t('Form will auto-complete while user is typing.'),
+    '#title' => t('Auto-complete (while user is typing)?'),
     '#default_value' => $edit['autocomplete'],
     '#description' => t('For security, auto-complete will be disabled if the user does not have access to user profiles.'),
   );
   $form['fields']['required'] = array('#type' => 'checkbox',
-    '#title' => t('The user must enter a value.'),
+    '#title' => t('Required?'),
     '#default_value' => $edit['required'],
   );
   $form['fields']['register'] = array('#type' => 'checkbox',
-    '#title' => t('Visible in user registration form.'),
+    '#title' => t('Visible during registration?'),
     '#default_value' => $edit['register'],
   );