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

Developed in https://github.com/WordPress/wordpress-develop/pull/10931

Follow-up to [61638].

Props noruzzaman, huzaifaalmesbah, westonruter.
See #64224.

Built from https://develop.svn.wordpress.org/trunk@61657


git-svn-id: http://core.svn.wordpress.org/trunk@60968 1a063a9b-81f0-0310-95a4-ce76da25c4cd

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

@@ -1132,7 +1132,7 @@ class WP_Debug_Data {
 	 *
 	 * @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.
 	 */

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

@@ -279,7 +279,7 @@ class WP_Importer {
 	 * @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;

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

@@ -42,10 +42,10 @@ class WP_Links_List_Table extends WP_List_Table {
 	}
 
 	/**
-	 * @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 @@ class WP_Links_List_Table extends WP_List_Table {
 	}
 
 	/**
+	 * 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 @@ class WP_Links_List_Table extends WP_List_Table {
 	}
 
 	/**
-	 * @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 @@ class WP_Links_List_Table extends WP_List_Table {
 	}
 
 	/**
+	 * Gets the list of sortable columns.
+	 *
 	 * @return array
 	 */
 	protected function get_sortable_columns() {
@@ -224,7 +229,7 @@ class WP_Links_List_Table extends WP_List_Table {
 	 *
 	 * @since 4.3.0
 	 *
-	 * @global int $cat_id
+	 * @global int $cat_id Link category ID.
 	 *
 	 * @param object $link The current link object.
 	 */

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

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

wp-includes/version.php

@@ -16,7 +16,7 @@
  *
  * @global string $wp_version
  */
-$wp_version = '7.0-alpha-61656';
+$wp_version = '7.0-alpha-61657';
 
 /**
  * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.