Index: modules/field/field.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/field/field.module,v
retrieving revision 1.48
diff -u -r1.48 field.module
--- modules/field/field.module	26 Nov 2009 19:09:32 -0000	1.48
+++ modules/field/field.module	29 Nov 2009 10:50:41 -0000
@@ -148,7 +148,25 @@
 function field_help($path, $arg) {
   switch ($path) {
     case 'admin/help#field':
-      $output = '<p>' . t('The Field API allows custom data fields to be attached to Drupal objects and takes care of storing, loading, editing, and rendering field data. Any object type (node, user, etc.) can use the Field API to make itself "fieldable" and thus allow fields to be attached to it.') . '</p>';
+      $output = '';
+      $output .= '<h3>' . t('About') . '</h3>';
+      $output .= '<p>' . t('The field module allows custom data fields to be attached to Drupal objects and takes care of storing, loading, editing, and rendering field data. Any object type (node, user, etc.) can use the Field API to make itself "fieldable" and thus allow fields to be attached to it.') . '</p>';
+      $output .= '<h3>' . t('Uses') . '</h3>';
+      $output .= '<dl>';
+      $output .= '<dt>' . t('User interface') . '</dt>';
+      $output .= '<dd>' . t('The field module itself is generally used only by module developers who want to provide new field types to Drupal. Administrative users who want to attach fields to Drupal objects can use the field UI module. (See the <a href="@field-ui-help">field UI module help page</a> for more information.)', array('@field-ui-help' => url('admin/help/field_ui'))) . '</dd>';
+      $output .= '<dt>' . t('Field types') . '</dt>';
+      $output .= '<dd>' . t('Drupal core includes the following categories of field types (additional field types may be provided by other modules):');
+      $output .= '<dl>';
+      $output .= '<dt>' . t('Number') . '</dt>';
+      $output .= '<dd>' . t('Fields for storing numbers, in integer, decimal or floating point form. You may define a set of allowed inputs, or specify an allowable range of values. Several common formats for displaying numeric data are available.') . '</dd>';
+      $output .= '<dt>' . t('Text') . '</dt>';
+      $output .= '<dd>' . t( "Fields for storing text. A text field may contain plain text only, or optionally, may use Drupal's input format filters to securely manage HTML output. Text input fields may be either a single line (text field), multiple lines (text area), or for greater input control, a select box, checkbox, or radio buttons. If desired, the field can be validated, so that it is limited to a set of allowed values.") . '</dd>';
+      $output .= '<dt>' . t('List') . '</dt>';
+      $output .= '<dd>' . t('Fields for storing a list of items. Usually these items are input through a select list, checkboxes, or radio buttons.') . '</dd>';
+      $output .= '</dl>';
+      $output .= '</dd>';
+      $output .= '</dl>';
       return $output;
   }
 }