From 5432d10c5861de41a30045d9bc8710473b67a35d Mon Sep 17 00:00:00 2001
From: Andrew Nacin <wp@andrewnacin.com>
Date: Thu, 5 Sep 2013 16:12:09 +0000
Subject: [PATCH] Fixes for hook inline docs in wp-comments-post.php. see
 #25229.

Built from https://develop.svn.wordpress.org/trunk@25251


git-svn-id: http://core.svn.wordpress.org/trunk@25219 1a063a9b-81f0-0310-95a4-ce76da25c4cd
---
 wp-comments-post.php | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/wp-comments-post.php b/wp-comments-post.php
index 65bae479f8..ab916617b6 100644
--- a/wp-comments-post.php
+++ b/wp-comments-post.php
@@ -26,7 +26,7 @@ if ( empty( $post->comment_status ) ) {
 	 * Fires when a comment is attempted on a post that does not exist
 	 *
 	 * @since unknown
-	 * @param int $comment_post_ID Post ID
+	 * @param int $comment_post_ID Post ID.
 	 */
 	do_action( 'comment_id_not_found', $comment_post_ID );
 	exit;
@@ -42,7 +42,7 @@ if ( ! comments_open( $comment_post_ID ) ) {
 	 * Fires when a comment is attempted on a post that has comments closed
 	 *
 	 * @since unknown
-	 * @param int $comment_post_ID Post ID
+	 * @param int $comment_post_ID Post ID.
 	 */
 	do_action( 'comment_closed', $comment_post_ID );
 	wp_die( __('Sorry, comments are closed for this item.') );
@@ -51,7 +51,7 @@ if ( ! comments_open( $comment_post_ID ) ) {
 	 * Fires when a comment is attempted on a trashed post
 	 *
 	 * @since 2.9.0
-	 * @param int $comment_post_ID Post ID
+	 * @param int $comment_post_ID Post ID.
 	 */
 	do_action( 'comment_on_trash', $comment_post_ID );
 	exit;
@@ -60,7 +60,7 @@ if ( ! comments_open( $comment_post_ID ) ) {
 	 * Fires when a comment is attempted on a post in draft mode
 	 *
 	 * @since unknown
-	 * @param int $comment_post_ID Post ID
+	 * @param int $comment_post_ID Post ID.
 	 */
 	do_action( 'comment_on_draft', $comment_post_ID );
 	exit;
@@ -69,7 +69,7 @@ if ( ! comments_open( $comment_post_ID ) ) {
 	 * Fires when a comment is attempted on a password-protected post
 	 *
 	 * @since unknown
-	 * @param int $comment_post_ID Post ID
+	 * @param int $comment_post_ID Post ID.
 	 */
 	do_action( 'comment_on_password_protected', $comment_post_ID );
 	exit;
@@ -78,7 +78,7 @@ if ( ! comments_open( $comment_post_ID ) ) {
 	 * Fires before a comment is posted
 	 *
 	 * @since unknown
-	 * @param int $comment_post_ID Post ID
+	 * @param int $comment_post_ID Post ID.
 	 */
 	do_action( 'pre_comment_on_post', $comment_post_ID );
 }
@@ -133,8 +133,8 @@ $comment = get_comment($comment_id);
  *
  * @since 3.4.0
  *
- * @param object $comment Comment object
- * @param object $user    WP_User object
+ * @param object $comment Comment object.
+ * @param WP_User $user   User object. The user may not exist.
  */
 do_action( 'set_comment_cookies', $comment, $user );
 
@@ -145,8 +145,8 @@ $location = empty($_POST['redirect_to']) ? get_comment_link($comment_id) : $_POS
  *
  * @since unknown
  *
- * @param string $location The 'redirect_to' URI sent via $_POST
- * @param object $comment  Comment object
+ * @param string $location The 'redirect_to' URI sent via $_POST.
+ * @param object $comment  Comment object.
  */
 $location = apply_filters( 'comment_post_redirect', $location, $comment );