Enhance get_comments() phpdoc.

git-svn-id: http://svn.automattic.com/wordpress/trunk@11169 1a063a9b-81f0-0310-95a4-ce76da25c4cd

wp-includes/comment.php

@@ -168,6 +168,8 @@ function &get_comment(&$comment, $output = OBJECT) {
 /**
  * Retrieve a list of comments.
  *
+ * The comment list can be for the blog as a whole or for an individual post.
+ * 
  * The list of comment arguments are 'status', 'orderby', 'comment_date_gmt',
  * 'order', 'number', 'offset', and 'post_id'.
  *