Improve @return documentation for WP_Comment_Query::get_comments().

Props barryceelen.
Fixes #36896.

git-svn-id: https://develop.svn.wordpress.org/trunk@37482 602fd350-edb4-49c9-b593-d223f7449a82

src/wp-includes/class-wp-comment-query.php

@@ -361,7 +361,7 @@ class WP_Comment_Query {
 	 *
 	 * @global wpdb $wpdb WordPress database abstraction object.
 	 *
-	 * @return int|array The list of comments.
+	 * @return int|array List of comments or number of found comments if `$count` argument is true.
 	 */
 	public function get_comments() {
 		global $wpdb;