diff --git wp-includes/comment-template.php wp-includes/comment-template.php
index 41031cb..3f70ddf 100755
--- wp-includes/comment-template.php
+++ wp-includes/comment-template.php
@@ -873,9 +873,9 @@ function get_comments_number( $post_id = 0 ) {
  *
  * @since 0.71
  *
- * @param string $zero       Optional. Text for no comments. Default false.
- * @param string $one        Optional. Text for one comment. Default false.
- * @param string $more       Optional. Text for more than one comment. Default false.
+ * @param false|string $zero       Optional. Text for no comments. Default false.
+ * @param false|string $one        Optional. Text for one comment. Default false.
+ * @param false|string $more       Optional. Text for more than one comment. Default false.
  * @param string $deprecated Not used.
  */
 function comments_number( $zero = false, $one = false, $more = false, $deprecated = '' ) {
@@ -885,14 +885,16 @@ function comments_number( $zero = false, $one = false, $more = false, $deprecate
 	echo get_comments_number_text( $zero, $one, $more );
 }
 
-/**
+/**`
  * Display the language string for the number of comments the current post has.
  *
  * @since 4.0.0
  *
- * @param string $zero Optional. Text for no comments. Default false.
- * @param string $one  Optional. Text for one comment. Default false.
- * @param string $more Optional. Text for more than one comment. Default false.
+ * @param false|string $zero Optional. Text for no comments. Default false.
+ * @param false|string $one  Optional. Text for one comment. Default false.
+ * @param false|string $more Optional. Text for more than one comment. Default false.
+ *
+ * @return string
  */
 function get_comments_number_text( $zero = false, $one = false, $more = false ) {
 	$number = get_comments_number();
@@ -1085,9 +1087,9 @@ function get_comment_type( $comment_ID = 0 ) {
  *
  * @since 0.71
  *
- * @param string $commenttxt   Optional. String to display for comment type. Default false.
- * @param string $trackbacktxt Optional. String to display for trackback type. Default false.
- * @param string $pingbacktxt  Optional. String to display for pingback type. Default false.
+ * @param false|string $commenttxt   Optional. String to display for comment type. Default false.
+ * @param false|string $trackbacktxt Optional. String to display for trackback type. Default false.
+ * @param false|string $pingbacktxt  Optional. String to display for pingback type. Default false.
  */
 function comment_type( $commenttxt = false, $trackbacktxt = false, $pingbacktxt = false ) {
 	if ( false === $commenttxt ) {
@@ -1176,7 +1178,7 @@ function trackback_url( $deprecated_echo = true ) {
  *
  * @since 0.71
  *
- * @param int $deprecated Not used (Was $timezone = 0).
+ * @param string|int $deprecated Not used (Was $timezone = 0).
  */
 function trackback_rdf( $deprecated = '' ) {
 	if ( ! empty( $deprecated ) ) {
@@ -1923,13 +1925,13 @@ function comment_id_fields( $id = 0 ) {
  *
  * @global WP_Comment $comment Current comment.
  *
- * @param string $noreplytext  Optional. Text to display when not replying to a comment.
- *                             Default false.
- * @param string $replytext    Optional. Text to display when replying to a comment.
- *                             Default false. Accepts "%s" for the author of the comment
- *                             being replied to.
- * @param string $linktoparent Optional. Boolean to control making the author's name a link
- *                             to their comment. Default true.
+ * @param false|string $noreplytext  Optional. Text to display when not replying to a comment.
+ *                                   Default false.
+ * @param false|string $replytext    Optional. Text to display when replying to a comment.
+ *                                   Default false. Accepts "%s" for the author of the comment
+ *                                   being replied to.
+ * @param true|string $linktoparent  Optional. Boolean to control making the author's name a link
+ *                                   to their comment. Default true.
  */
 function comment_form_title( $noreplytext = false, $replytext = false, $linktoparent = true ) {
 	global $comment;
@@ -1990,6 +1992,8 @@ function comment_form_title( $noreplytext = false, $replytext = false, $linktopa
  *     @type bool   $echo              Whether to echo the output or return it. Default true.
  * }
  * @param array $comments Optional. Array of WP_Comment objects.
+ *
+ * @return void|string
  */
 function wp_list_comments( $args = array(), $comments = null ) {
 	global $wp_query, $comment_alt, $comment_depth, $comment_thread_alt, $overridden_cpage, $in_comment_loop;