Docs: Add missing descriptions for WP_Media_List_Table methods.

Follow-up to [11749], [15491], [31162], [32654], [61594].

Props noruzzaman.
See #64224.

git-svn-id: https://develop.svn.wordpress.org/trunk@61683 602fd350-edb4-49c9-b593-d223f7449a82

Author: SergeyBiryukov

src/wp-admin/includes/class-wp-media-list-table.php

@@ -23,8 +23,20 @@ class WP_Media_List_Table extends WP_List_Table {
 	 */
 	protected $comment_pending_count = array();
 
+	/**
+	 * Whether the list table is for detached media.
+	 *
+	 * @since 3.1.0
+	 * @var bool
+	 */
 	private $detached;
 
+	/**
+	 * Whether the list table is for trash.
+	 *
+	 * @since 3.1.0
+	 * @var bool
+	 */
 	private $is_trash;
 
 	/**
@@ -53,17 +65,25 @@ public function __construct( $args = array() ) {
 	}
 
 	/**
+	 * Checks if the current user has permissions to upload files.
+	 *
+	 * @since 3.1.0
+	 *
 	 * @return bool Whether the user can upload files.
 	 */
 	public function ajax_user_can() {
 		return current_user_can( 'upload_files' );
 	}
 
 	/**
+	 * Prepares the list of items for displaying.
+	 *
+	 * @since 3.1.0
+	 *
 	 * @global string   $mode                  List table view mode.
 	 * @global WP_Query $wp_query              WordPress Query object.
-	 * @global array    $post_mime_types
-	 * @global array    $avail_post_mime_types
+	 * @global array    $post_mime_types       An array of post mime types.
+	 * @global array    $avail_post_mime_types An array of available post mime types.
 	 */
 	public function prepare_items() {
 		global $mode, $wp_query, $post_mime_types, $avail_post_mime_types;
@@ -117,8 +137,12 @@ public function prepare_items() {
 	}
 
 	/**
-	 * @global array $post_mime_types
-	 * @global array $avail_post_mime_types
+	 * Gets an array of links for the available views on this table.
+	 *
+	 * @since 3.1.0
+	 *
+	 * @global array $post_mime_types       An array of post mime types.
+	 * @global array $avail_post_mime_types An array of available post mime types.
 	 * @return array<string, string> An array of links for the available views.
 	 */
 	protected function get_views() {
@@ -198,7 +222,11 @@ protected function get_bulk_actions() {
 	}
 
 	/**
-	 * @param string $which
+	 * Displays extra controls between bulk actions and pagination.
+	 *
+	 * @since 3.1.0
+	 *
+	 * @param string $which The location of the extra table nav: 'top' or 'bottom'.
 	 */
 	protected function extra_tablenav( $which ) {
 		if ( 'bar' !== $which ) {
@@ -253,6 +281,9 @@ public function has_items() {
 	}
 
 	/**
+	 * Displays a message when no media items are found.
+	 *
+	 * @since 3.1.0
 	 */
 	public function no_items() {
 		if ( $this->is_trash ) {
@@ -762,8 +793,12 @@ protected function get_default_primary_column_name() {
 	}
 
 	/**
-	 * @param WP_Post $post
-	 * @param string  $att_title
+	 * Gets the row actions for a media item.
+	 *
+	 * @since 3.1.0
+	 *
+	 * @param WP_Post $post      The current WP_Post object.
+	 * @param string  $att_title The attachment title.
 	 * @return array<string, string> An array of row actions.
 	 */
 	private function _get_row_actions( $post, $att_title ) {