From ea9451bd1ccade810b9351c10484f2797fe963f6 Mon Sep 17 00:00:00 2001
From: Rachel Baker <rachelbaker@git.wordpress.org>
Date: Thu, 31 Dec 2015 19:20:21 +0000
Subject: [PATCH] Docs: Add null to `post_id` param type, fix syntax, and
 descriptions in the DocBlock for `wp_update_comment_count()`.

See #32246.



git-svn-id: https://develop.svn.wordpress.org/trunk@36139 602fd350-edb4-49c9-b593-d223f7449a82
---
 src/wp-includes/comment.php | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/src/wp-includes/comment.php b/src/wp-includes/comment.php
index c6dd33d911..3354d2b72d 100644
--- a/src/wp-includes/comment.php
+++ b/src/wp-includes/comment.php
@@ -2003,9 +2003,11 @@ function wp_defer_comment_counting($defer=null) {
  *
  * @staticvar array $_deferred
  *
- * @param int $post_id Post ID
- * @param bool $do_deferred Whether to process previously deferred post comment counts
- * @return bool|void True on success, false on failure
+ * @param int|null $post_id     Post ID.
+ * @param bool     $do_deferred Optional. Whether to process previously deferred
+ *                              post comment counts. Default false.
+ * @return bool|void True on success, false on failure or if post with ID does
+ *                   not exist.
  */
 function wp_update_comment_count($post_id, $do_deferred=false) {
 	static $_deferred = array();