Document globals in bundled themes

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

@@ -7,6 +7,9 @@
  * @since Twenty Eleven 1.0
  */
 
+/**
+ * @global string $feature_class Classes for post container of featured posts.
+ */
 global $feature_class;
 ?>
 <article id="post-<?php the_ID(); ?>" <?php post_class( $feature_class ); ?>>

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

@@ -70,6 +70,8 @@
 	 * @uses set_post_thumbnail_size()  To set a custom post thumbnail size.
 	 *
 	 * @since Twenty Eleven 1.0
+	 *
+	 * @global string $wp_version WordPress version.
 	 */
 	function twentyeleven_setup() {
 
@@ -637,6 +639,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 ) {
@@ -741,6 +745,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

@@ -26,7 +26,12 @@
 <meta name="viewport" content="width=device-width" />
 <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  WordPress paginated post page count.
+	 * @global int $paged WordPress archive pagination page count.
+	 */
 	global $page, $paged;
 
 	wp_title( '|', true, 'right' );

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
+						 */
 						global $more;
 						$more = 0;
 

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

@@ -36,6 +36,8 @@
 
 /**
  * Twenty Fifteen only works in WordPress 4.1 or later.
+ *
+ * @global string $wp_version WordPress version.
  */
 if ( version_compare( $GLOBALS['wp_version'], '4.1-alpha', '<' ) ) {
 	require get_template_directory() . '/inc/back-compat.php';
@@ -50,6 +52,8 @@
 	 * as indicating support for post thumbnails.
 	 *
 	 * @since Twenty Fifteen 1.0
+	 *
+	 * @global string $wp_version WordPress version.
 	 */
 	function twentyfifteen_setup() {
 
@@ -498,6 +502,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 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 WordPress version.
  */
 function twentyfifteen_upgrade_notice() {
 	printf(
@@ -48,6 +50,8 @@ function twentyfifteen_upgrade_notice() {
  * Prevent the Customizer from being loaded on WordPress versions prior to 4.1.
  *
  * @since Twenty Fifteen 1.0
+ *
+ * @global string $wp_version WordPress version.
  */
 function twentyfifteen_customize() {
 	wp_die(
@@ -68,6 +72,8 @@ function twentyfifteen_customize() {
  * Prevent the Theme Preview from being loaded on WordPress versions prior to 4.1.
  *
  * @since Twenty Fifteen 1.0
+ *
+ * @global string $wp_version WordPress version.
  */
 function twentyfifteen_preview() {
 	if ( isset( $_GET['preview'] ) ) {

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

@@ -38,6 +38,8 @@
 
 /**
  * Twenty Fourteen only works in WordPress 3.6 or later.
+ *
+ * @global string $wp_version WordPress version.
  */
 if ( version_compare( $GLOBALS['wp_version'], '3.6', '<' ) ) {
 	require get_template_directory() . '/inc/back-compat.php';
@@ -54,6 +56,8 @@
 	 * as indicating support post thumbnails.
 	 *
 	 * @since Twenty Fourteen 1.0
+	 *
+	 * @global string $wp_version WordPress version.
 	 */
 	function twentyfourteen_setup() {
 
@@ -226,6 +230,8 @@ function twentyfourteen_setup() {
  * Adjust content_width value for image attachment template.
  *
  * @since Twenty Fourteen 1.0
+ *
+ * @global int $content_width Content width.
  */
 function twentyfourteen_content_width() {
 	if ( is_attachment() && wp_attachment_is_image() ) {
@@ -417,6 +423,8 @@ function twentyfourteen_admin_fonts() {
  * @since Twenty Fourteen 1.9
  * @deprecated Twenty Fourteen 3.6 Disabled filter because, by default, fonts are self-hosted.
  *
+ * @global string $wp_version 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.
@@ -524,6 +532,8 @@ function twentyfourteen_the_attached_image() {
 	 * Print a list of all site contributors who published at least one post.
 	 *
 	 * @since Twenty Fourteen 1.0
+	 *
+	 * @global string $wp_version WordPress version.
 	 */
 	function twentyfourteen_list_authors() {
 		$args = array(
@@ -596,6 +606,8 @@ function twentyfourteen_list_authors() {
  *
  * @since Twenty Fourteen 1.0
  *
+ * @global string $pagenow The filename of the current screen.
+ *
  * @param array $classes A list of existing body class values.
  * @return array The filtered body class list.
  */
@@ -736,6 +748,8 @@ function twentyfourteen_widget_tag_cloud_args( $args ) {
  *
  * To overwrite in a plugin, define your own Featured_Content class on or
  * before the 'setup_theme' hook.
+ *
+ * @global string $pagenow The filename of the current screen.
  */
 if ( ! class_exists( 'Featured_Content' ) && 'plugins.php' !== $GLOBALS['pagenow'] ) {
 	require get_template_directory() . '/inc/featured-content.php';

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

@@ -32,6 +32,8 @@ function twentyfourteen_switch_theme() {
  * Twenty Fourteen on WordPress versions prior to 3.6.
  *
  * @since Twenty Fourteen 1.0
+ *
+ * @global string $wp_version WordPress version.
  */
 function twentyfourteen_upgrade_notice() {
 	printf(
@@ -48,6 +50,8 @@ function twentyfourteen_upgrade_notice() {
  * Prevent the Customizer from being loaded on WordPress versions prior to 3.6.
  *
  * @since Twenty Fourteen 1.0
+ *
+ * @global string $wp_version WordPress version.
  */
 function twentyfourteen_customize() {
 	wp_die(
@@ -68,6 +72,8 @@ function twentyfourteen_customize() {
  * Prevent the Theme Preview from being loaded on WordPress versions prior to 3.4.
  *
  * @since Twenty Fourteen 1.0
+ *
+ * @global string $wp_version WordPress version.
  */
 function twentyfourteen_preview() {
 	if ( isset( $_GET['preview'] ) ) {

src/wp-content/themes/twentyfourteen/inc/customizer.php

@@ -150,6 +150,8 @@ function twentyfourteen_customize_preview_js() {
  * Add contextual help to the Themes and Post edit screens.
  *
  * @since Twenty Fourteen 1.0
+ *
+ * @global string $typenow The post type of the current screen.
  */
 function twentyfourteen_contextual_help() {
 	if ( 'admin_head-edit.php' === current_filter() && 'post' !== $GLOBALS['typenow'] ) {

src/wp-content/themes/twentyfourteen/inc/widgets.php

@@ -67,6 +67,9 @@ public function enqueue_scripts() {
 	 *
 	 * @since Twenty Fourteen 1.0
 	 *
+	 * @global int $content_width Content width.
+	 * @global int $more
+	 *
 	 * @param array $args     An array of standard parameters for widgets in this theme.
 	 * @param array $instance An array of settings for this widget instance.
 	 */

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

@@ -11,6 +11,8 @@
 
 /**
  * Twenty Nineteen only works in WordPress 4.7 or later.
+ *
+ * @global string $wp_version WordPress version.
  */
 if ( version_compare( $GLOBALS['wp_version'], '4.7', '<' ) ) {
 	require get_template_directory() . '/inc/back-compat.php';

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

@@ -11,6 +11,8 @@
 
 /**
  * Twenty Seventeen only works in WordPress 4.7 or later.
+ *
+ * @global string $wp_version WordPress version.
  */
 if ( version_compare( $GLOBALS['wp_version'], '4.7-alpha', '<' ) ) {
 	require get_template_directory() . '/inc/back-compat.php';
@@ -23,6 +25,10 @@
  * Note that this function is hooked into the after_setup_theme hook, which
  * runs before the init hook. The init hook is too late for some features, such
  * as indicating support for post thumbnails.
+ *
+ * @since Twenty Seventeen 1.0
+ *
+ * @global int $content_width Content width.
  */
 function twentyseventeen_setup() {
 
@@ -248,7 +254,7 @@ function twentyseventeen_setup() {
  *
  * Priority 0 to make it available to lower priority callbacks.
  *
- * @global int $content_width
+ * @global int $content_width Content width.
  */
 function twentyseventeen_content_width() {
 

src/wp-content/themes/twentyseventeen/template-parts/page/content-front-page-panels.php

@@ -8,6 +8,9 @@
  * @version 1.0
  */
 
+/**
+ * @global int|string $twentyseventeencounter Front page section counter.
+ */
 global $twentyseventeencounter;
 
 ?>

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

@@ -27,6 +27,8 @@
 
 /**
  * Twenty Sixteen only works in WordPress 4.4 or later.
+ *
+ * @global string $wp_version WordPress version.
  */
 if ( version_compare( $GLOBALS['wp_version'], '4.4-alpha', '<' ) ) {
 	require get_template_directory() . '/inc/back-compat.php';
@@ -43,6 +45,8 @@
 	 * Create your own twentysixteen_setup() function to override in a child theme.
 	 *
 	 * @since Twenty Sixteen 1.0
+	 *
+	 * @global string $wp_version WordPress version.
 	 */
 	function twentysixteen_setup() {
 		/*
@@ -241,9 +245,9 @@ function twentysixteen_setup() {
  *
  * Priority 0 to make it available to lower priority callbacks.
  *
- * @global int $content_width
- *
  * @since Twenty Sixteen 1.0
+ *
+ * @global int $content_width Content width.
  */
 function twentysixteen_content_width() {
 	$GLOBALS['content_width'] = apply_filters( 'twentysixteen_content_width', 840 );

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

@@ -72,6 +72,8 @@
 	 * @uses set_post_thumbnail_size()  To set a custom post thumbnail size.
 	 *
 	 * @since Twenty Ten 1.0
+	 *
+	 * @global string $wp_version WordPress version.
 	 */
 	function twentyten_setup() {
 
@@ -434,7 +436,12 @@ function twentyten_custom_excerpt_more( $output ) {
 function twentyten_remove_gallery_css( $css ) {
 	return preg_replace( "#<style type='text/css'>(.*?)</style>#s", '', $css );
 }
-// Backward compatibility with WordPress 3.0.
+
+/**
+ * Backward compatibility with WordPress 3.0.
+ *
+ * @global string $wp_version WordPress version.
+ */
 if ( version_compare( $GLOBALS['wp_version'], '3.1', '<' ) ) {
 	add_filter( 'gallery_style', 'twentyten_remove_gallery_css' );
 }
@@ -450,8 +457,10 @@ function twentyten_remove_gallery_css( $css ) {
 	 *
 	 * @since Twenty Ten 1.0
 	 *
+	 * @global WP_Comment $comment Global comment object.
+	 *
 	 * @param WP_Comment $comment The comment object.
-	 * @param array      $args    An array of arguments. @see get_comment_reply_link()
+	 * @param array      $args    An array of comment arguments. @see get_comment_reply_link()
 	 * @param int        $depth   The depth of the comment.
 	 */
 	function twentyten_comment( $comment, $args, $depth ) {

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

@@ -16,6 +16,9 @@
 <?php
 	/*
 	 * Print the <title> tag based on what is being viewed.
+	 *
+	 * @global int $page  WordPress paginated post page count.
+	 * @global int $paged WordPress archive pagination page count.
 	 */
 	global $page, $paged;
 

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

@@ -40,6 +40,8 @@
 
 /**
  * Twenty Thirteen only works in WordPress 3.6 or later.
+ *
+ * @global string $wp_version WordPress version.
  */
 if ( version_compare( $GLOBALS['wp_version'], '3.6-alpha', '<' ) ) {
 	require get_template_directory() . '/inc/back-compat.php';
@@ -66,6 +68,8 @@
  * @uses set_post_thumbnail_size() To set a custom post thumbnail size.
  *
  * @since Twenty Thirteen 1.0
+ *
+ * @global string $wp_version WordPress version.
  */
 function twentythirteen_setup() {
 	/*
@@ -357,6 +361,8 @@ function twentythirteen_scripts_styles() {
  * @since Twenty Thirteen 2.1
  * @deprecated Twenty Thirteen 3.8 Disabled filter because, by default, fonts are self-hosted.
  *
+ * @global string $wp_version 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.
@@ -483,6 +489,8 @@ function wp_get_list_item_separator() {
 	 * Display navigation to next/previous set of posts when applicable.
 	 *
 	 * @since Twenty Thirteen 1.0
+	 *
+	 * @global WP_Query $wp_query WordPress Query object.
 	 */
 	function twentythirteen_paging_nav() {
 		global $wp_query;