From f43e6e1d3854b924a4d7c95aee993e7a1390c063 Mon Sep 17 00:00:00 2001
From: Drew Jaynes <drewapicture@git.wordpress.org>
Date: Mon, 13 Jul 2015 17:48:07 +0000
Subject: [PATCH] Add missing summaries, `@access` tags, and some parameter
 descriptions to methods added to `WP_Posts_List_Table` in 4.3.

See [32740]. See #32891.


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

diff --git a/src/wp-admin/includes/class-wp-posts-list-table.php b/src/wp-admin/includes/class-wp-posts-list-table.php
index 414f63a96d..7c9ae710ef 100644
--- a/src/wp-admin/includes/class-wp-posts-list-table.php
+++ b/src/wp-admin/includes/class-wp-posts-list-table.php
@@ -48,7 +48,10 @@ class WP_Posts_List_Table extends WP_List_Table {
 	private $is_trash;
 
 	/**
+	 * Current level for output.
+	 *
 	 * @since 4.3.0
+	 * @access protected
 	 * @var int
 	 */
 	protected $current_level = 0;
@@ -677,9 +680,12 @@ class WP_Posts_List_Table extends WP_List_Table {
 	}
 
 	/**
-	 * @since 4.3.0
+	 * Handles the checkbox column output.
 	 *
-	 * @param WP_Post $post
+	 * @since 4.3.0
+	 * @access public
+	 *
+	 * @param WP_Post $post The current WP_Post object.
 	 */
 	public function column_cb( $post ) {
 		if ( current_user_can( 'edit_post', $post->ID ) ): ?>
@@ -692,11 +698,14 @@ class WP_Posts_List_Table extends WP_List_Table {
 	}
 
 	/**
+	 * Handles the title column output.
+	 *
 	 * @since 4.3.0
+	 * @access public
 	 *
 	 * @global string $mode
 	 *
-	 * @param WP_Post $post
+	 * @param WP_Post $post The current WP_Post object.
 	 */
 	public function column_title( $post ) {
 		global $mode;
@@ -772,11 +781,14 @@ class WP_Posts_List_Table extends WP_List_Table {
 	}
 
 	/**
+	 * Handles the post date column output.
+	 *
 	 * @since 4.3.0
+	 * @access public
 	 *
 	 * @global string $mode
 	 *
-	 * @param WP_Post $post
+	 * @param WP_Post $post The current WP_Post object.
 	 */
 	public function column_date( $post ) {
 		global $mode;
@@ -834,9 +846,12 @@ class WP_Posts_List_Table extends WP_List_Table {
 	}
 
 	/**
-	 * @since 4.3.0
+	 * Handles the comments column output.
 	 *
-	 * @param WP_Post $post
+	 * @since 4.3.0
+	 * @access public
+	 *
+	 * @param WP_Post $post The current WP_Post object.
 	 */
 	public function column_comments( $post ) {
 		?>
@@ -851,9 +866,12 @@ class WP_Posts_List_Table extends WP_List_Table {
 	}
 
 	/**
-	 * @since 4.3.0
+	 * Handles the post author column output.
 	 *
-	 * @param WP_Post $post
+	 * @since 4.3.0
+	 * @access public
+	 *
+	 * @param WP_Post $post The current WP_Post object.
 	 */
 	public function column_author( $post ) {
 		printf( '<a href="%s">%s</a>',
@@ -863,10 +881,13 @@ class WP_Posts_List_Table extends WP_List_Table {
 	}
 
 	/**
-	 * @since 4.3.0
+	 * Handles the default column output.
 	 *
-	 * @param WP_Post $post
-	 * @param string  $column_name
+	 * @since 4.3.0
+	 * @access public
+	 *
+	 * @param WP_Post $post        The current WP_Post object.
+	 * @param string  $column_name The current column name.
 	 */
 	public function column_default( $post, $column_name ) {
 		if ( 'categories' == $column_name ) {
@@ -952,9 +973,12 @@ class WP_Posts_List_Table extends WP_List_Table {
 	}
 
 	/**
-	 * @since 4.3.0
+	 * Handles columns output for a single row in the table.
 	 *
-	 * @param WP_Post $item
+	 * @since 4.3.0
+	 * @access public
+	 *
+	 * @param WP_Post $item The current WP_Post object.
 	 */
 	public function single_row_columns( $item ) {
 		list( $columns, $hidden, $sortable, $primary ) = $this->get_column_info();
@@ -1037,7 +1061,7 @@ class WP_Posts_List_Table extends WP_List_Table {
 	}
 
 	/**
-	 * Get the name of the default primary column.
+	 * Gets the name of the default primary column.
 	 *
 	 * @since 4.3.0
 	 * @access protected
@@ -1049,7 +1073,7 @@ class WP_Posts_List_Table extends WP_List_Table {
 	}
 
 	/**
-	 * Generate and display row actions links.
+	 * Generates and displays row action links.
 	 *
 	 * @since 4.3.0
 	 * @access protected