Docs: Add missing @global descriptions and refine parameter documentations in wp-admin/includes classes.

Developed in #10931

Follow-up to [61638].

Props noruzzaman, huzaifaalmesbah, westonruter.
See #64224.


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

Author: westonruter

src/wp-admin/includes/class-wp-debug-data.php

@@ -1132,7 +1132,7 @@ private static function get_wp_plugins_raw_data(): array {
 	 *
 	 * @since 6.7.0
 	 *
-	 * @global array $_wp_theme_features
+	 * @global array<string, bool|array> $_wp_theme_features The theme features for the active theme.
 	 *
 	 * @return array<string, string|array> The active theme debug data.
 	 */

src/wp-admin/includes/class-wp-importer.php

@@ -279,7 +279,7 @@ public function min_whitespace( $text ) {
 	 * @since 3.0.0
 	 *
 	 * @global wpdb  $wpdb       WordPress database abstraction object.
-	 * @global int[] $wp_actions
+	 * @global int[] $wp_actions Stores the number of times each action was triggered.
 	 */
 	public function stop_the_insanity() {
 		global $wpdb, $wp_actions;

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

@@ -42,10 +42,10 @@ public function ajax_user_can() {
 	}
 
 	/**
-	 * @global int    $cat_id
-	 * @global string $s
-	 * @global string $orderby
-	 * @global string $order
+	 * @global int    $cat_id  Link category ID.
+	 * @global string $s       Search string.
+	 * @global string $orderby The field to order the links by.
+	 * @global string $order   The direction to order the links.
 	 */
 	public function prepare_items() {
 		global $cat_id, $s, $orderby, $order;
@@ -77,12 +77,15 @@ public function prepare_items() {
 	}
 
 	/**
+	 * Displays the message for no items.
 	 */
 	public function no_items() {
 		_e( 'No links found.' );
 	}
 
 	/**
+	 * Gets the list of bulk actions.
+	 *
 	 * @return array
 	 */
 	protected function get_bulk_actions() {
@@ -93,8 +96,8 @@ protected function get_bulk_actions() {
 	}
 
 	/**
-	 * @global int $cat_id
-	 * @param string $which
+	 * @global int $cat_id Link category ID.
+	 * @param string $which The location: 'top' or 'bottom'.
 	 */
 	protected function extra_tablenav( $which ) {
 		global $cat_id;
@@ -142,6 +145,8 @@ public function get_columns() {
 	}
 
 	/**
+	 * Gets the list of sortable columns.
+	 *
 	 * @return array
 	 */
 	protected function get_sortable_columns() {
@@ -224,7 +229,7 @@ public function column_url( $link ) {
 	 *
 	 * @since 4.3.0
 	 *
-	 * @global int $cat_id
+	 * @global int $cat_id Link category ID.
 	 *
 	 * @param object $link The current link object.
 	 */

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

@@ -1692,7 +1692,7 @@ protected function display_tablenav( $which ) {
 	 *
 	 * @since 3.1.0
 	 *
-	 * @param string $which
+	 * @param string $which The location: 'top' or 'bottom'.
 	 */
 	protected function extra_tablenav( $which ) {}