From 5b06d42c510457f15668984cd180de97fa75a245 Mon Sep 17 00:00:00 2001
From: Drew Jaynes <drewapicture@git.wordpress.org>
Date: Sun, 31 May 2015 01:17:25 +0000
Subject: [PATCH] Add missing return descriptions and fix formatting of inline
 documentation introduced in [32644].

See #25408. See #32246.


git-svn-id: https://develop.svn.wordpress.org/trunk@32660 602fd350-edb4-49c9-b593-d223f7449a82
---
 .../includes/class-wp-comments-list-table.php     | 15 +++++++--------
 1 file changed, 7 insertions(+), 8 deletions(-)

diff --git a/src/wp-admin/includes/class-wp-comments-list-table.php b/src/wp-admin/includes/class-wp-comments-list-table.php
index 4b381c858d..5326063868 100644
--- a/src/wp-admin/includes/class-wp-comments-list-table.php
+++ b/src/wp-admin/includes/class-wp-comments-list-table.php
@@ -375,12 +375,12 @@ class WP_Comments_List_Table extends WP_List_Table {
 	}
 
 	/**
-	 * Get name of default primary column
+	 * Get the name of the default primary column.
 	 *
 	 * @since 4.3.0
 	 * @access protected
 	 *
-	 * @return string
+	 * @return string Name of the default primary column, in this case, 'comment'.
 	 */
 	protected function get_default_primary_column_name() {
 		return 'comment';
@@ -449,16 +449,15 @@ class WP_Comments_List_Table extends WP_List_Table {
 	}
 
  	/**
- 	 * Generate and display row actions links
+ 	 * Generate and display row actions links.
  	 *
  	 * @since 4.3.0
  	 * @access protected
  	 *
- 	 * @param object $comment Comment being acted upon
- 	 * @param string $column_name Current column name
- 	 * @param string $primary Primary column name
- 	 *
- 	 * @return string|void
+ 	 * @param object $comment     Comment being acted upon.
+ 	 * @param string $column_name Current column name.
+ 	 * @param string $primary     Primary column name.
+ 	 * @return string|void Comment row actions output.
  	 */
  	protected function handle_row_actions( $comment, $column_name, $primary ) {
  		global $comment_status;