Index: modules/comment/comment.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/comment/comment.module,v
retrieving revision 1.749
diff -u -p -r1.749 comment.module
--- modules/comment/comment.module	4 Aug 2009 06:53:48 -0000	1.749
+++ modules/comment/comment.module	7 Aug 2009 00:25:20 -0000
@@ -86,11 +86,32 @@ define('COMMENT_PREVIEW_REQUIRED', 1);
 function comment_help($path, $arg) {
   switch ($path) {
     case 'admin/help#comment':
-      $output  = '<p>' . t('The comment module allows visitors to comment on your posts, creating ad hoc discussion boards. Any <a href="@content-type">content type</a> may have its <em>Default comment setting</em> set to <em>Open</em> to allow comments, <em>Hidden</em> to hide existing comments and prevent new comments or <em>Closed</em> to allow existing comments to be viewed but no new comments added. Comment display settings and other controls may also be customized for each content type.', array('@content-type' => url('admin/structure/types'))) . '</p>';
-      $output .= '<p>' . t('Comment permissions are assigned to user roles, and are used to determine whether anonymous users (or other roles) are allowed to comment on posts. If anonymous users are allowed to comment, their individual contact information may be retained in cookies stored on their local computer for use in later comment submissions. When a comment has no replies, it may be (optionally) edited by its author. The comment module uses the same text formats and HTML tags available when creating other forms of content.') . '</p>';
-      $output .= '<p>' . t('Change comment settings on the content type\'s <a href="@content-type">edit page</a>.', array('@content-type' => url('admin/structure/types'))) . '</p>';
-      $output .= '<p>' . t('For more information, see the online handbook entry for <a href="@comment">Comment module</a>.', array('@comment' => 'http://drupal.org/handbook/modules/comment/')) . '</p>';
-
+      $output = '<h3>' . t('About') . '</h3>';
+      $output .= '<p>' . t('Allows visitors to comment on nodes, creating ad hoc discussion boards.') . '</p>';
+      $output .= '<h3>' . t('Use') . '</h3>';
+      $output .= '<dl>';
+      $output .= '<dt>' . t('Default comment settings') . '</dt>';
+      $output .= '<dd>';
+      $output .= '<p>' . t('Any <a href="@content-type">content type</a> may use one of the following Default comment settings:', array('@content-type' => url('admin/build/types'))) . '</p><ul>';
+      $output .= '<li>' . t('<em>Hidden</em>: hides existing comments and prevent new comments.'). '</li>';
+      $output .= '<li>' . t('<em>Open</em>: allows comments.') . '</li>';
+      $output .= '<li>' . t('<em>Closed</em>: allows existing comments to be viewed but no new comments added.') . '</li></ul>';
+      $output .= '<p>' . t('Comment settings can be configured for each <a href="@content-type">content type</a>. Select the appropriate "edit" link for the content type you want to alter. The settings are available in a fieldset named, "Comment settings.".', array('@content-type' => url('admin/build/types'))) . '</p>';
+      $output .= '</dd>';
+      $output .= '<dt>' . t('User permissions') . '</dt>';
+      $output .= '<dd><p>' . t('<a href="@permissions">Comment permissions</a> are assigned to user roles, and determine which user roles are allowed to leave comments. Each role may be configured to allow, or disallow, the following tasks: Administer comments, Access comments, Post comments, Post comments without approval.', array('@permissions' => url('admin/user/permissions#module-comment'))) . '</p>';
+      $output .= '<p>' . t('The comment module can be extended by contributed modules to include <a href="@spam-modules">spam filtering</a>.', array('@spam-modules' => url('http://drupal.org/node/206787'))) . '</p></dd>';
+      $output .= '<dt>' . t('Administering contributed comments') . '</dt>';
+      $output .= '<dd><p>' . t('Published comments are linked from their relevant node. In addition, all comments are listed in the <a href="@admin-comments">Comment section of the Content Management administration area</a>. From this screen you may perform bulk operations to unpublish and delete comments.') . '</p></dd>';
+      $output .= '</dl>'; 
+      $output .= '<h3>' . t('Theme') . '</h3>';
+      $output .= '<ul><li><a href="http://api.drupal.org/api/file/modules/comment/comment.tpl.php/7">comment.tpl.php</a></li>';
+      $output .= '<li><a href="http://api.drupal.org/api/file/modules/comment/comment-folded.tpl.php/7">comment-folded.tpl.php</a></li>';
+      $output .= '<li><a href="http://api.drupal.org/api/file/modules/comment/comment-wrapper.tpl.php/7">comment-wrapper.tpl.php</a></li></ul>';
+      $output .= '<h3>' . t('Develop') . '</h3>';
+      $output .= '<p>' . t('<a href="@api-comment">API documentation for the comment module</a>.', array('@api-comment' => 'http://api.drupal.org/api/file/modules/comment/comment.module/7')) . '</p>';
+      $output .= '<h3>' . t('Handbook Documentation') . '</h3>';
+      $output .= '<p>' . t('<a href="@handbook-comment">Drupal Handbook documentation for the comment module</a>.', array('@handbook-comment' => 'http://http://drupal.org/handbook/modules/comment/')) . '</p>';
       return $output;
   }
 }