--- modules/search/search.module	2009-11-08 11:02:41.000000000 +0100
+++ modules/search/search.module	2009-11-27 21:15:52.000000000 +0100
@@ -96,13 +96,23 @@ define('PREG_CLASS_CJK', '\x{3041}-\x{30
 function search_help($path, $arg) {
   switch ($path) {
     case 'admin/help#search':
-      $output = '<p>' . t('The search module adds the ability to search for content by keywords. Search is often the only practical way to find content on a large site, and is useful for finding both users and posts.') . '</p>';
-      $output = '<p>' . t('It is important to note that by default, the search module only supports exact keyword matching. You can modify this behavior by installing a language-specific stemming module for your language, which allows words such as walk, walking, and walked all to match each other. Another approach is to install an n-gram module, which breaks words down into small, overlapping chunks and finds words with a high degree of overlap, so that words like earthquake and quake can match each other. A third approach is to use a third-party search technology with features like this built in; there are modules available for several of these, such as Apache Solr and Sphinx.') . '</p>';
-      $output .= '<p>' . t('To provide keyword searching, the search engine maintains an index of words found in your site\'s content. To build and maintain this index, a correctly configured <a href="@cron">cron maintenance task</a> is required. Indexing behavior can be adjusted using the <a href="@searchsettings">search settings page</a>; for example, the <em>Number of items to index per cron run</em> sets the maximum number of items indexed in each pass of a <a href="@cron">cron maintenance task</a>. If necessary, reduce this number to prevent timeouts and memory errors when indexing.', array('@cron' => url('admin/reports/status'), '@searchsettings' => url('admin/config/search/settings'))) . '</p>';
-      $output .= '<p>' . t('For more information, see the online handbook entry for <a href="@search">Search module</a>.', array('@search' => 'http://drupal.org/handbook/modules/search/')) . '</p>';
+      $output = '';
+      $output .= '<h3>' . t('About') . '</h3>';
+      $output .= '<p>' . t('The Search module lets you search for content by keywords. Users with <a href="@perm">sufficient permissions</a> can search for users by username or e-mail. The Search module also includes an <em>advanced search</em> option on the <a href="@search">Search page</a> that allows more complex searches, and filtering the search by content type. For more information, see the online handbook entry for <a href="@search-module">Search module</a>.', array('@search-module' => 'http://drupal.org/handbook/modules/search/', '@perm' => url('admin/config/people/permissions', array('fragment' => 'module-user')),'@search' => url('search'))) . '</p>';
+      $output .= '<h3>' . t('Uses') . '</h3>';
+      $output .= '<dl>';
+      $output .= '<dt>' . t('Indexing content with cron') . '</dt>';
+      $output .= '<dd>' . t("To provide keyword searching, the search engine maintains an index of words found the content. To build and maintain this index, a correctly configured <a href='@cron'>cron maintenance task</a> is required. You can further configure the cron settings on the <a href='@searchsettings'>Search settings page</a>.", array('@cron' => 'http://drupal.org/cron', '@searchsettings' => url('admin/config/search/settings'))) . '</dd>';
+      $output .= '<dt>' . t('Configuring search settings') . '</dt>';
+      $output .= '<dd>' . t('Indexing behavior can be adjusted using the <a href="@searchsettings">Search settings page</a>. You can control settings such as the <em>Number of items to index per cron run</em>, <em>Indexing settings</em> (word length), <em>Active search modules</em>, and <em>Content ranking</em> which lets you adjust the priority in which indexed content is returned in results.', array('@searchsettings' => url('admin/config/search/settings'))) . '</dd>';
+      $output .= '<dt>' . t('Search block') . '</dt>';
+      $output .= '<dd>' . t('Enabling the Search module provides a default <em>Search form</em> block, which can be enabled and configured on the <a href="@blocks">Blocks administration page</a>.', array('@blocks' => url('admin/structure/block'))) . '</dd>';
+      $output .= '<dt>' . t('Extending Search module') . '</dt>';
+      $output .= '<dd>' . t('By default, the Search module only supports exact keyword matching. You can modify this behavior by installing a language-specific stemming module for your language, which allows words such as walk, walking, and walked to be matched. Another approach is to install an n-gram module, which breaks words down into small, overlapping chunks and finds words with a high degree of overlap, so that words like earthquake and quake can be matched. A third approach is to use a third-party search technology with features like this built in, such as Apache Solr and Sphinx. These <a href="@contributed">contributed modules</a> can be downloaded by visiting Drupal.org.', array('@contributed' => 'http://drupal.org/project/Modules/')) . '</dd>';
+      $output .= '</dl>';
       return $output;
     case 'admin/config/search/settings':
-      return '<p>' . t('The search engine maintains an index of words found in your site\'s content. To build and maintain this index, a correctly configured <a href="@cron">cron maintenance task</a> is required. Indexing behavior can be adjusted using the settings below.', array('@cron' => url('admin/reports/status'))) . '</p>';
+      return '<p>' . t("The search engine maintains an index of words found in your site's content. To build and maintain this index, a correctly configured <a href='@cron'>cron maintenance task</a> is required. Indexing behavior can be adjusted using the settings below.", array('@cron' => 'http://drupal.org/cron')) . '</p>';
     case 'search#noresults':
       return t('<ul>
 <li>Check if your spelling is correct.</li>
