Index: modules/dashboard/dashboard.info
===================================================================
RCS file: /cvs/drupal/drupal/modules/dashboard/dashboard.info,v
retrieving revision 1.2
diff -u -p -r1.2 dashboard.info
--- modules/dashboard/dashboard.info	17 Nov 2009 21:24:18 -0000	1.2
+++ modules/dashboard/dashboard.info	23 Nov 2009 23:54:21 -0000
@@ -1,6 +1,6 @@
 ; $Id: dashboard.info,v 1.2 2009/11/17 21:24:18 dries Exp $
 name = Dashboard
-description = A module that provides a dashboard interface for organizing and tracking various information within your site.
+description = Provides a dashboard page in the administrative interface for organizing administrative tasks and tracking information within your site.
 core = 7.x
 package = Core
 version = VERSION
Index: modules/dashboard/dashboard.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/dashboard/dashboard.module,v
retrieving revision 1.5
diff -u -p -r1.5 dashboard.module
--- modules/dashboard/dashboard.module	11 Nov 2009 08:52:27 -0000	1.5
+++ modules/dashboard/dashboard.module	23 Nov 2009 23:54:21 -0000
@@ -2,6 +2,26 @@
 // $Id: dashboard.module,v 1.5 2009/11/11 08:52:27 dries Exp $
 
 /**
+ * Implements hook_help().
+ */
+function dashboard_help($path, $arg) {
+  switch ($path) {
+    case 'admin/help#dashboard':
+      $output = '';
+      $output .= '<h3>' . t('About') . '</h3>';
+      $output .= '<p>' . t('The Dashboard module provides a <a href="@dashboard">Dashboard page</a> in the administrative interface for organizing administrative tasks and navigation, and tracking information within your site. The Dashboard page contains blocks, which you can add to and arrange using the drag and drop interface that appears when you click on the <em>Customize</em> link.', array('@dashboard' => url('admin/dashboard'))) . '</p>';
+      $output .= '<h3>' . t('Uses') . '</h3>';
+      $output .= '<dl>';
+      $output .= '<dt>' . t('Tracking user activity') . '</dt>';
+      $output .= '<dd>' . t("By enabling blocks such as <em>Who's online</em> and <em>Who's new</em>, site users can track who is logged in and new user signups at a centralized location.") . '</dd>';
+      $output .= '<dt>' . t('Tracking content activity') . '</dt>';
+      $output .= '<dd>' . t('By enabling blocks such as <em>Recent blog posts</em>, <em>New forum topics</em>and <em>Recent comments</em>, site users can view newly added site content at a glance.') . '</dd>';
+      $output .= '</dl>';
+      return $output;
+  }
+}
+
+/**
  * Implement hook_menu().
  */
 function dashboard_menu() {
Index: modules/poll/poll.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/poll/poll.module,v
retrieving revision 1.324
diff -u -p -r1.324 poll.module
--- modules/poll/poll.module	18 Nov 2009 18:51:11 -0000	1.324
+++ modules/poll/poll.module	23 Nov 2009 23:54:22 -0000
@@ -13,9 +13,16 @@
 function poll_help($path, $arg) {
   switch ($path) {
     case 'admin/help#poll':
-      $output = '<p>' . t('The poll module can be used to create simple polls for site users. A poll is a simple, multiple choice questionnaire which displays the cumulative results of the answers to the poll. Having polls on the site is a good way to receive feedback from community members.') . '</p>';
-      $output .= '<p>' . t('When creating a poll, enter the question being posed, as well as the potential choices (and beginning vote counts for each choice). The status and duration (length of time the poll remains active for new votes) can also be specified. Use the <a href="@poll">poll</a> menu item to view all current polls. To vote in or view the results of a specific poll, click on the poll itself.', array('@poll' => url('poll'))) . '</p>';
-      $output .= '<p>' . t('For more information, see the online handbook entry for <a href="@poll">Poll module</a>.', array('@poll' => 'http://drupal.org/handbook/modules/poll/')) . '</p>';
+      $output = '';
+      $output .= '<h3>' . t('About') . '</h3>';
+      $output .= '<p>' . t('The Poll module can be used to create simple surveys or questionnaires which display the cumulative results. A poll is a good way to receive feedback from site users and community members. For more information, see the online handbook entry for <a href="@poll">Poll module</a>.', array('@poll' => 'http://drupal.org/handbook/modules/poll/')) . '</p>';
+      $output .= '<h3>' . t('Uses') . '</h3>';
+      $output .= '<dl>';
+      $output .= '<dt>' . t('Creating a poll') . '</dt>';
+      $output .= '<dd>' . t('Users can create a poll by clicking on Poll on the <a href="@add-content">Add content</a> page, and entering the question being posed, as well as the potential choices (and beginning vote counts for each choice). The status (closed or active) and duration (length of time the poll remains active for new votes) can also be specified.', array('@add-content' => url('node/add'))) . '</dd>';
+      $output .= '<dt>' . t('Viewing polls') . '</dt>';
+      $output .= '<dd>' . t('Visit the <a href="@poll">Polls</a> page to view all current polls, or enable the "Most recent poll" block on the <a href="@blocks">Blocks administration page</a>. To vote in or view the results of a specific poll, you can click on the poll itself.', array('@poll' => url('poll'), '@blocks' => url('admin/structure/block'))) . '</dd>';
+      $output .= '</dl>';
       return $output;
   }
 }
Index: modules/toolbar/toolbar.info
===================================================================
RCS file: /cvs/drupal/drupal/modules/toolbar/toolbar.info,v
retrieving revision 1.3
diff -u -p -r1.3 toolbar.info
--- modules/toolbar/toolbar.info	17 Oct 2009 00:51:53 -0000	1.3
+++ modules/toolbar/toolbar.info	23 Nov 2009 23:54:22 -0000
@@ -1,6 +1,6 @@
 ; $Id: toolbar.info,v 1.3 2009/10/17 00:51:53 dries Exp $
 name = Toolbar
-description = Toolbar exposing the top level administration menu items.
+description = Provides a toolbar that shows the top-level administration menu items and configured shortcuts.
 core = 7.x
 package = Core
 version = VERSION
Index: modules/toolbar/toolbar.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/toolbar/toolbar.module,v
retrieving revision 1.22
diff -u -p -r1.22 toolbar.module
--- modules/toolbar/toolbar.module	19 Nov 2009 03:57:15 -0000	1.22
+++ modules/toolbar/toolbar.module	23 Nov 2009 23:54:22 -0000
@@ -7,6 +7,19 @@
  */
 
 /**
+ * Implements hook_help().
+ */
+function toolbar_help($path, $arg) {
+  switch ($path) {
+    case 'admin/help#toolbar':
+      $output = '';
+      $output .= '<h3>' . t('About') . '</h3>';
+      $output .= '<p>' . t('The Toolbar module provides links to top-level administration menu items and configured <a href="@shortcuts-help">shortcuts</a> at the top of the screen for any user with proper permissions.', array('@shortcuts-help' => url('admin/help/shortcut'))) . '</p>';
+      return $output;
+  }
+}
+
+/**
  * Implementation of hook_permission().
  */
 function toolbar_permission() {
Index: modules/update/update.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/update/update.module,v
retrieving revision 1.53
diff -u -p -r1.53 update.module
--- modules/update/update.module	25 Oct 2009 19:52:47 -0000	1.53
+++ modules/update/update.module	23 Nov 2009 23:54:23 -0000
@@ -108,10 +108,14 @@ function update_help($path, $arg) {
       break;
 
     case 'admin/help#update':
-      $output = '<p>' . t("The Update status module periodically checks for new versions of your site's software (including contributed modules and themes), and alerts you to available updates.") . '</p>';
-      $output .= '<p>' . t('The <a href="@update-report">report of available updates</a> will alert you when new releases are available for download. You may configure options for update checking frequency and notifications at the <a href="@update-settings">Update status module settings page</a>.', array('@update-report' => url('admin/reports/updates'), '@update-settings' => url('admin/reports/updates/settings'))) . '</p>';
-      $output .= '<p>' . t('Please note that in order to provide this information, anonymous usage statistics are sent to drupal.org. If desired, you may disable the Update status module from the <a href="@modules">module administration page</a>.', array('@modules' => url('admin/config/modules'))) . '</p>';
-      $output .= '<p>' . t('For more information, see the online handbook entry for <a href="@update">Update status module</a>.', array('@update' => 'http://drupal.org/handbook/modules/update')) . '</p>';
+      $output = '';
+      $output .= '<h3>' . t('About') . '</h3>';
+      $output .= '<p>' . t("The Update status module periodically checks for new versions of your site's software (including contributed modules and themes), and alerts you to available updates. In order to provide this information, anonymous usage statistics are sent to Drupal.org. If desired, you may disable the Update status module from the <a href='@modules'>module administration page</a>. For more information, see the online handbook entry for <a href='@update'>Update status module</a>.", array('@update' => 'http://drupal.org/handbook/modules/update', '@modules' => url('admin/config/modules'))) . '</p>';
+      $output .= '<h3>' . t('Uses') . '</h3>';
+      $output .= '<dl>';
+      $output .= '<dt>' . t('Checking for available updates') . '</dt>';
+      $output .= '<dd>' . t('The report of <a href="@update-report">available updates</a> will alert you when new releases are available for download. You may configure options for update checking frequency and notifications at the <a href="@update-settings">Update status module</a> settings page.', array('@update-report' => url('admin/reports/updates'), '@update-settings' => url('admin/reports/updates/settings'))) . '</dd>';
+      $output .= '</dl>';
       return $output;
 
     default: