Index: modules/path/path.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/path/path.module,v
retrieving revision 1.175
diff -u -p -r1.175 path.module
--- modules/path/path.module	8 Nov 2009 10:02:41 -0000	1.175
+++ modules/path/path.module	26 Nov 2009 14:56:23 -0500
@@ -12,15 +12,22 @@
 function path_help($path, $arg) {
   switch ($path) {
     case 'admin/help#path':
-      $output = '<p>' . t('The path module allows you to specify aliases for Drupal URLs. Such aliases improve readability of URLs for your users and may help internet search engines to index your content more effectively. More than one alias may be created for a given page.') . '</p>';
-      $output .= '<p>' . t('Some examples of URL aliases are:') . '</p>';
-      $output .= '<ul><li>' . t('%alias for the path %path', array('%alias' => 'login', '%path' => 'user/login')) . '</li>';
-      $output .= '<li>' . t('%alias for the path %path', array('%alias' => 'store', '%path' => 'image/tid/16')) . '</li>';
-      $output .= '<li>' . t('%alias for the path %path', array('%alias' => 'store/products/whirlygigs', '%path' => 'taxonomy/term/7+19+20+21')) . '</li>';
-      $output .= '<li>' . t('%alias for the path %path', array('%alias' => 'contact', '%path' => 'node/3')) . '</li></ul>';
-      $output .= '<p>' . t('The path module enables appropriately permissioned users to specify an optional alias in all node input and editing forms, and provides an interface to view and edit all URL aliases. The two permissions related to URL aliasing are <em>administer url aliases</em> and <em>create url aliases</em>.') . ' </p>';
-      $output .= '<p>' . t('This module also provides user-defined mass URL aliasing capabilities, which is useful if you wish to uniformly use URLs different from the default. For example, you may want to have your URLs presented in a different language. Access to the Drupal source code on the web server is required to set up mass URL aliasing.') . ' </p>';
-      $output .= '<p>' . t('For more information, see the online handbook entry for <a href="@path">Path module</a>.', array('@path' => 'http://drupal.org/handbook/modules/path/')) . '</p>';
+      $output = '';
+      $output .= '<h3>' . t('About') . '</h3>';
+      $output .= '<p>' . t('The path module allows you to specify aliases for any internal system path. Aliases are commonly used to create paths that can improve the readability of URLs for users and help search engines index content. If required, multiple aliases may be used for a single internal system path.') . '</p>';
+      $output .= '<h3>' . t('Uses') . '</h3>';
+      $output .= '<dl>';
+      $output .= '<dt>' . t('Creating aliases') . '</dt>';
+      $output .= '<dd>' . t('Users with sufficient <a href="@permissions@">permissions</a> can create aliases under the <em>URL path settings</em> section when they <a href="@createnode">create</a> or edit content. Some examples of aliases are: ', array('@permissions' => url('admin/config/people/permissions#module-path'),'@createnode' => url('node/add')));
+      $output .= '<ul><li>' . t('<em>member/jane-smith</em> for the path <em>user/123</em>') . '</li>';
+      $output .= '<li>' . t('<em>photo/jane-smith-before-eiffel-tower</em> for the path <em>node/456</em>') . '</li>';
+      $output .= '<li>' . t('<em>store/products/cheese</em> for the path <em>taxonomy/term/7</em>') . '</li>';
+      $output .= '<li>' . t('<em>news/jane-smith-opens-new-cheese-shop-near-the-eiffel-tower</em> for the path <em>node/89</em>') . '</li>';
+      $output .= '</ul></dd>';
+      $output .= '<dt>' . t('Managing aliases') . '</dt>';
+      $output .= '<dd>' . t('The path module also provides the a way to search and view a <a href="@aliases">list of all aliases</a> that are in use on your website. From this list aliases can be added, edited and deleted', array('@aliases' => url('admin/config/search/path'))) . '</dd>';
+      $output .= '</dl>';
+      $output .= '<p>' . t('The enabling of <a href="@cleanurl">clean URLs</a> will remove ?q= from the path if your web server supported it at the time your site was installed. In combination with the contributed module <a href="">pathauto</a> you can create <strong>automatic aliases</strong> for all content in your site.', array('@cleanurl' => url('admin/config/search/clean-urls'), '@pathauto' => url('http://drupal.org/project/pathauto'))) . ' </p>';
+      $output .= '<p>' . t('For more information, see the online handbook entry for the <a href="@path">path module</a>.', array('@path' => 'http://drupal.org/handbook/modules/path/')) . '</p>';
       return $output;
 
     case 'admin/config/search/path':