Add missing doc blocks to class-wp-theme.php.

See #32444.


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

src/wp-includes/comment.php

@@ -454,7 +454,7 @@ class WP_Comment_Query {
 	 * @access public
 	 *
 	 * @param string|array $query Array or URL query string of parameters.
-	 * @return array List of comments.
+	 * @return array|int List of comments, or number of comments when 'count' is passed as a query var.
 	 */
 	public function query( $query ) {
 		$this->query_vars = wp_parse_args( $query );