Docs: Systematically add missing @global annotations for global variables

src/wp-admin/includes/misc.php

@@ -492,6 +492,9 @@ function wp_make_plugin_file_tree( $plugin_editable_files ) {
  * @since 4.9.0
  * @access private
  *
+ * @global string $file   Path to the file being edited.
+ * @global string $plugin Path to the plugin file relative to the plugins directory.
+ *
  * @param array|string $tree  List of file/folder paths, or filename.
  * @param string       $label Name of file or folder to print.
  * @param int          $level The aria-level for the current iteration.

src/wp-admin/includes/schema.php

@@ -12,8 +12,8 @@
  * Declare these as global in case schema.php is included from a function.
  *
  * @global wpdb   $wpdb            WordPress database abstraction object.
- * @global array  $wp_queries
- * @global string $charset_collate
+ * @global array  $wp_queries      Global database queries array.
+ * @global string $charset_collate Database charset and collation.
  */
 global $wpdb, $wp_queries, $charset_collate;
 

src/wp-admin/install.php

@@ -342,6 +342,7 @@ function display_setup_form( $error = null ) {
 /**
  * @global string    $wp_local_package Locale code of the package.
  * @global WP_Locale $wp_locale        WordPress date and time locale object.
+ * @global wpdb      $wpdb             WordPress database abstraction object.
  */
 $language = '';
 if ( ! empty( $_REQUEST['language'] ) ) {

src/wp-content/themes/twentyeleven/content-featured.php

@@ -7,6 +7,9 @@
  * @since Twenty Eleven 1.0
  */
 
+/**
+ * @global string $feature_class CSS classes for the article element.
+ */
 global $feature_class;
 ?>
 <article id="post-<?php the_ID(); ?>" <?php post_class( $feature_class ); ?>>

src/wp-content/themes/twentyeleven/functions.php

@@ -83,6 +83,8 @@ function twentyeleven_setup() {
 		 * Manual loading of text domain is not required after the introduction of
 		 * just in time translation loading in WordPress version 4.6.
 		 *
+		 * @global string $wp_version The WordPress version.
+		 *
 		 * @ticket 58318
 		 */
 		if ( version_compare( $GLOBALS['wp_version'], '4.6', '<' ) ) {
@@ -636,6 +638,8 @@ function twentyeleven_widgets_init() {
 	 *
 	 * @since Twenty Eleven 1.0
 	 *
+	 * @global WP_Query $wp_query WordPress query object.
+	 *
 	 * @param string $html_id The HTML id attribute.
 	 */
 	function twentyeleven_content_nav( $html_id ) {
@@ -753,6 +757,8 @@ function twentyeleven_footer_sidebar_class() {
 	 *
 	 * @since Twenty Eleven 1.0
 	 *
+	 * @global WP_Comment $comment Global comment object.
+	 *
 	 * @param WP_Comment $comment The comment object.
 	 * @param array      $args    An array of comment arguments. @see get_comment_reply_link()
 	 * @param int        $depth   The depth of the comment.

src/wp-content/themes/twentyeleven/header.php

@@ -15,7 +15,12 @@
 <meta name="viewport" content="width=device-width, initial-scale=1.0" />
 <title>
 <?php
-	// Print the <title> tag based on what is being viewed.
+	/**
+	 * Print the <title> tag based on what is being viewed.
+	 *
+	 * @global int $page  The current page number for multi-paged posts.
+	 * @global int $paged The current page number for the archive.
+	 */
 	global $page, $paged;
 
 	wp_title( '|', true, 'right' );
@@ -98,9 +103,11 @@
 				?>
 			<a href="<?php echo esc_url( home_url( '/' ) ); ?>" rel="home" <?php echo $is_front ? 'aria-current="page"' : ''; ?>>
 				<?php
-				/*
+				/**
 				 * The header image.
-				 * Check if this is a post or page, if it has a thumbnail, and if it's a big one
+				 * Check if this is a post or page, if it has a thumbnail, and if it's a big one.
+				 *
+				 * @global WP_Post $post Global post object.
 				 */
 				$image = false;
 				if ( is_singular() && has_post_thumbnail( $post->ID ) ) {

src/wp-content/themes/twentyeleven/showcase.php

@@ -208,7 +208,11 @@
 					if ( $recent->have_posts() ) :
 						$recent->the_post();
 
-						// Set $more to 0 in order to only get the first part of the post.
+						/**
+						 * Set $more to 0 in order to only get the first part of the post.
+						 *
+						 * @global int $more Whether to display the full post or just the teaser.
+						 */
 						global $more;
 						$more = 0;
 

src/wp-content/themes/twentyfifteen/functions.php

@@ -29,6 +29,8 @@
  * Set the content width based on the theme's design and stylesheet.
  *
  * @since Twenty Fifteen 1.0
+ *
+ * @global int $content_width The content width.
  */
 if ( ! isset( $content_width ) ) {
 	$content_width = 660;
@@ -62,6 +64,8 @@ function twentyfifteen_setup() {
 		 * Manual loading of text domain is not required after the introduction of
 		 * just in time translation loading in WordPress version 4.6.
 		 *
+		 * @global string $wp_version The WordPress version.
+		 *
 		 * @ticket 58318
 		 */
 
@@ -499,6 +503,8 @@ function twentyfifteen_block_editor_styles() {
  * @since Twenty Fifteen 1.7
  * @deprecated Twenty Fifteen 3.4 Disabled filter because, by default, fonts are self-hosted.
  *
+ * @global string $wp_version The WordPress version.
+ *
  * @param array   $urls          URLs to print for resource hints.
  * @param string  $relation_type The relation type the URLs are printed.
  * @return array URLs to print for resource hints.

src/wp-content/themes/twentyfifteen/inc/back-compat.php

@@ -32,6 +32,8 @@ function twentyfifteen_switch_theme() {
  * Twenty Fifteen on WordPress versions prior to 4.1.
  *
  * @since Twenty Fifteen 1.0
+ *
+ * @global string $wp_version The WordPress version.
  */
 function twentyfifteen_upgrade_notice() {
 	printf(
@@ -48,6 +50,8 @@ function twentyfifteen_upgrade_notice() {
  * Prevents the Customizer from being loaded on WordPress versions prior to 4.1.
  *
  * @since Twenty Fifteen 1.0
+ *
+ * @global string $wp_version The WordPress version.
  */
 function twentyfifteen_customize() {
 	wp_die(
@@ -68,6 +72,8 @@ function twentyfifteen_customize() {
  * Prevents the Theme Preview from being loaded on WordPress versions prior to 4.1.
  *
  * @since Twenty Fifteen 1.0
+ *
+ * @global string $wp_version The WordPress version.
  */
 function twentyfifteen_preview() {
 	if ( isset( $_GET['preview'] ) ) {

src/wp-includes/abilities.php

@@ -39,6 +39,8 @@ function wp_register_core_ability_categories(): void {
  *
  * @since 6.9.0
  *
+ * @global wpdb $wpdb WordPress database abstraction object.
+ *
  * @return void
  */
 function wp_register_core_abilities(): void {