Index: pathauto.module
===================================================================
RCS file: /cvs/drupal-contrib/contributions/modules/pathauto/pathauto.module,v
retrieving revision 1.44.2.1
diff -u -r1.44.2.1 pathauto.module
--- pathauto.module	12 Nov 2006 17:29:43 -0000	1.44.2.1
+++ pathauto.module	29 Nov 2006 22:10:18 -0000
@@ -14,7 +14,19 @@
   $output = '';
   switch ($section) {
     case 'admin/help#pathauto':
-      $output = t('Provides a mechanism for modules to automatically generate aliases for the content they manage.');
+      $output = t("<p>Pathauto provides a mechanism to automatically generate aliases for the content they manage. On its own
+                  Pathauto can do this for core items like users, nodes, and taxonomy terms.  Through it's hook system, other
+                  modules can provide patterns and replacement text for use in Pathauto.</p>
+                  <h2>Settings</h2>
+                  <p>The <strong>Maximum Alias Length</strong> and <strong>Maximum component length</strong> values
+                  are default to 100 and have an enforced limit of 128.  This value is limited by the length of the dst 
+                  column of the url_alias database table. The default database schema for this column is 128. If you 
+                  set a length that is equal to that of the one set in the dst column, it will cause problems in situations 
+                  where the system needs to append additional words to the aliased URL, in order for that function to 
+                  work e.g. URL's generated for feeds will have '/feed' added to the end. You should enter a
+                  value that is the length of the dst column minus the length of any strings that might get added to the 
+                  end of the URL. The length of strings that might get added to the end of your URLs depends on which 
+                  modules you have enabled and on your Pathauto settings. The recommended and default value is 100.</p>");
       break;
   }
 
@@ -72,12 +84,14 @@
   $form["general"]["pathauto_max_length"] = array('#type' => 'textfield',
     '#title' => t('Maximum alias length'), '#size' => 3, '#maxlength' => 3,
     '#default_value' => variable_get('pathauto_max_length', 100),
-    '#description' => t('Maximum text length of aliases to generate. 128 is the maximum permissible.'));
+    '#description' => t('Maximum length of aliases to generate. 100 is recommended.  If 100 is characters is insufficient, please see the <a href="@pathauto-help">Pathauto help</a> for advanced details.', array('@pathauto-help' => url('admin/help/pathauto'))),
+    );
 
   $form["general"]["pathauto_max_component_length"] = array('#type' => 'textfield',
     '#title' => t('Maximum component length'), '#size' => 3, '#maxlength' => 3,
     '#default_value' => variable_get('pathauto_max_component_length', 100),
-    '#description' => t('Maximum text length of any single component in the alias (e.g., [title]). 128 is the maximum permissible.'));
+    '#description' => t('Maximum text length of any single component in the alias (e.g., [title]). 100 is recommended. If 100 is characters is insufficient, please see the <a href="@pathauto-help">Pathauto help</a> for advanced details.', array('@pathauto-help' => url('admin/help/pathauto'))),
+    );
 
   $form["general"]["pathauto_indexaliases"] = array('#type' => 'checkbox',
     '#title' => t('Create index aliases'),