Inline documentation for the following filter hooks in wp-includes/pluggable.php:

* `comment_notification_recipients`
* `comment_notification_notify_author`

Also removes some generic `@uses` tags from various related doc blocks.

Props markjaquith.
Fixes #25699.

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


git-svn-id: http://core.svn.wordpress.org/trunk@26288 1a063a9b-81f0-0310-95a4-ce76da25c4cd

wp-includes/comment.php

@@ -1378,15 +1378,6 @@ function wp_throttle_comment_flood($block, $time_lastcomment, $time_newcomment)
  *
  * @since 1.5.0
  * @param array $commentdata Contains information on the comment.
- * @uses apply_filters()
- * @uses wp_get_comment_status()
- * @uses wp_filter_comment()
- * @uses wp_allow_comment()
- * @uses wp_insert_comment()
- * @uses do_action()
- * @uses wp_notify_moderator()
- * @uses get_option()
- * @uses wp_notify_postauthor()
  * @return int The ID of the comment after adding.
  */
 function wp_new_comment( $commentdata ) {