--- modules/comment/comment.module	2010-02-01 11:58:00.000000000 -0600
+++ modules/comment/comment.modulenew	2010-02-16 22:00:37.000000000 -0600
@@ -1550,16 +1550,20 @@ function comment_form_submit($form, &$fo
 }
 
 /**
- * Theme a single comment block.
+ * Theme a single comment and related items.
  *
  * @param $comment
  *   The comment object.
  * @param $node
  *   The comment node.
  * @param $links
- *   An associative array containing control links.
+ *   An associative array containing control links suitable for passing into  
+ *   theme_links(). These are generated by modules implementing hook_link() with
+ *   $type='comment'. Typical examples are links for editing and deleting 
+ *   comments.
  * @param $visible
- *   Switches between folded/unfolded view.
+ *   Switches between folded/unfolded view. If TRUE the comments are visible, if 
+ *   FALSE the comments are folded.
  * @ingroup themeable
  */
 function theme_comment_view($comment, $node, $links = array(), $visible = TRUE) {