Docs: Improve documentation for ::display() methods in various list tables.

Props itowhid06.
Fixes #47947.

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

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

@@ -487,7 +487,9 @@ class WP_Comments_List_Table extends WP_List_Table {
 	}
 
 	/**
-	 * Display the comments table. Override the parent method to render extra comments.
+	 * Displays the comments table.
+	 *
+	 * Overrides the parent display() method to render extra comments.
 	 *
 	 * @since 3.1.0
 	 */

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

@@ -1173,7 +1173,7 @@ class WP_List_Table {
 	}
 
 	/**
-	 * Display the table
+	 * Displays the table.
 	 *
 	 * @since 3.1.0
 	 */

src/wp-admin/includes/class-wp-plugin-install-list-table.php

@@ -333,7 +333,11 @@ class WP_Plugin_Install_List_Table extends WP_List_Table {
 	}
 
 	/**
-	 * Override the parent display() so we can provide a different container.
+	 * Displays the plugin install table.
+	 *
+	 * Overrides the parent display() method to provide a different container.
+	 *
+	 * @since 4.0.0
 	 */
 	public function display() {
 		$singular = $this->_args['singular'];

src/wp-admin/includes/class-wp-theme-install-list-table.php

@@ -187,6 +187,11 @@ class WP_Theme_Install_List_Table extends WP_Themes_List_Table {
 	}
 
 	/**
+	 * Displays the theme install table.
+	 *
+	 * Overrides the parent display() method to provide a different container.
+	 *
+	 * @since 3.1.0
 	 */
 	public function display() {
 		wp_nonce_field( 'fetch-list-' . get_class( $this ), '_ajax_fetch_list_nonce' );

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

@@ -151,6 +151,11 @@ class WP_Themes_List_Table extends WP_List_Table {
 	}
 
 	/**
+	 * Displays the themes table.
+	 *
+	 * Overrides the parent display() method to provide a different container.
+	 *
+	 * @since 3.1.0
 	 */
 	public function display() {
 		wp_nonce_field( 'fetch-list-' . get_class( $this ), '_ajax_fetch_list_nonce' );