From 6b711ca35ed169af95320d3611c774bdd9a92293 Mon Sep 17 00:00:00 2001
From: Drew Jaynes <drewapicture@git.wordpress.org>
Date: Tue, 29 Oct 2013 17:35:13 +0000
Subject: [PATCH] Inline documentation for hooks in
 wp-admin/edit-form-comment.php.

Props rzen.
Fixes #25521.


git-svn-id: https://develop.svn.wordpress.org/trunk@25983 602fd350-edb4-49c9-b593-d223f7449a82
---
 src/wp-admin/edit-form-comment.php | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/src/wp-admin/edit-form-comment.php b/src/wp-admin/edit-form-comment.php
index 07c1946e1b..6537169d0e 100644
--- a/src/wp-admin/edit-form-comment.php
+++ b/src/wp-admin/edit-form-comment.php
@@ -49,7 +49,8 @@ if ( !defined('ABSPATH') )
 	<?php
 		if ( ! empty( $comment->comment_author_url ) && 'http://' != $comment->comment_author_url ) {
 			$link = '<a href="' . $comment->comment_author_url . '" rel="external nofollow" target="_blank">' . __('visit site') . '</a>';
-			printf( __( 'URL (%s):' ), apply_filters('get_comment_author_link', $link ) );
+			/** This filter is documented in wp-includes/comment-template.php */
+			printf( __( 'URL (%s):' ), apply_filters( 'get_comment_author_link', $link ) );
 		} else {
 			_e( 'URL:' );
 		} ?></td>
@@ -127,9 +128,17 @@ $date = date_i18n( $datef, strtotime( $comment->comment_date ) );
 
 <div id="postbox-container-2" class="postbox-container">
 <?php
+/** This action is documented in wp-admin/edit-form-advanced.php */
+do_action( 'add_meta_boxes', 'comment', $comment );
 
-do_action('add_meta_boxes', 'comment', $comment);
-do_action('add_meta_boxes_comment', $comment);
+/**
+ * Fires when comment-specific meta boxes are added.
+ *
+ * @since 3.0.0
+ *
+ * @param object $comment Comment object.
+ */
+do_action( 'add_meta_boxes_comment', $comment );
 
 do_meta_boxes(null, 'normal', $comment);