From df5ff389e939fcbcd57e176ce1960679b07ff3ec Mon Sep 17 00:00:00 2001
From: azaozz <azaozz@1a063a9b-81f0-0310-95a4-ce76da25c4cd>
Date: Mon, 22 Sep 2008 20:21:10 +0000
Subject: [PATCH] phpDoc corrections for comment.php, props jacobsantos, fixes
 #7550

git-svn-id: http://svn.automattic.com/wordpress/trunk@8956 1a063a9b-81f0-0310-95a4-ce76da25c4cd
---
 wp-includes/comment.php | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/wp-includes/comment.php b/wp-includes/comment.php
index 583cd2cec..e7d780851 100644
--- a/wp-includes/comment.php
+++ b/wp-includes/comment.php
@@ -14,6 +14,10 @@
  * links exceeds the amount in the administration, then the check fails. If any
  * of the parameter contents match the blacklist of words, then the check fails.
  *
+ * If the number of links exceeds the amount in the administration, then the
+ * check fails. If any of the parameter contents match the blacklist of words,
+ * then the check fails.
+ *
  * If the comment is a trackback and part of the blogroll, then the trackback is
  * automatically whitelisted. If the comment author was approved before, then
  * the comment is automatically whitelisted.
@@ -116,6 +120,9 @@ function get_approved_comments($post_id) {
  * after being passed through a filter. If the comment is empty, then the global
  * comment variable will be used, if it is set.
  *
+ * If the comment is empty, then the global comment variable will be used, if it
+ * is set.
+ *
  * @since 2.0.0
  * @uses $wpdb
  *
@@ -591,7 +598,7 @@ function wp_count_comments( $post_id = 0 ) {
  * @uses do_action() Calls 'wp_set_comment_status' hook on comment ID with 'delete' set for the second parameter
  *
  * @param int $comment_id Comment ID
- * @return bool False if delete comment query failure, true on success
+ * @return bool False if delete comment query failure, true on success.
  */
 function wp_delete_comment($comment_id) {
 	global $wpdb;
@@ -727,8 +734,8 @@ function wp_insert_comment($commentdata) {
  * @uses apply_filters() Calls 'pre_comment_author_url' hook on comment author's URL
  * @uses apply_filters() Calls 'pre_comment_author_email' hook on comment author's email address
  *
- * @param array $commentdata Contains information on the comment
- * @return array Parsed comment information
+ * @param array $commentdata Contains information on the comment.
+ * @return array Parsed comment information.
  */
 function wp_filter_comment($commentdata) {
 	$commentdata['user_id']              = apply_filters('pre_user_id', $commentdata['user_ID']);
@@ -775,7 +782,7 @@ function wp_throttle_comment_flood($block, $time_lastcomment, $time_newcomment)
  * @uses wp_allow_comment() checks to see if comment is approved.
  * @uses wp_insert_comment() Does the actual comment insertion to the database.
  *
- * @param array $commentdata Contains information on the comment
+ * @param array $commentdata Contains information on the comment.
  * @return int The ID of the comment after adding.
  */
 function wp_new_comment( $commentdata ) {