From f31de914f172773d9510dd0e838e1a36c5de25bf Mon Sep 17 00:00:00 2001
From: Sergey Biryukov <sergeybiryukov@git.wordpress.org>
Date: Tue, 15 Jun 2021 10:20:54 +0000
Subject: [PATCH] Docs: Document the usage of `$_wp_current_template_content`
 global in a few block template functions.

Follow-up to [51003], [51149].

See #52628.

git-svn-id: https://develop.svn.wordpress.org/trunk@51150 602fd350-edb4-49c9-b593-d223f7449a82
---
 src/wp-includes/block-template.php  | 7 ++++++-
 src/wp-includes/theme-templates.php | 4 +++-
 2 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/src/wp-includes/block-template.php b/src/wp-includes/block-template.php
index c93a083472..1a879c1670 100644
--- a/src/wp-includes/block-template.php
+++ b/src/wp-includes/block-template.php
@@ -12,6 +12,8 @@
  *
  * @since 5.8.0
  *
+ * @global string $_wp_current_template_content
+ *
  * @param string $template  Path to the template. See locate_template().
  * @param string $type      Sanitized filename without extension.
  * @param array  $templates A list of template candidates, in descending order of priority.
@@ -147,7 +149,10 @@ function _block_template_render_title_tag() {
  * @access private
  * @since 5.8.0
  *
- * @return string block tempate markup.
+ * @global string   $_wp_current_template_content
+ * @global WP_Embed $wp_embed
+ *
+ * @return string Block template markup.
  */
 function get_the_block_template_html() {
 	global $_wp_current_template_content;
diff --git a/src/wp-includes/theme-templates.php b/src/wp-includes/theme-templates.php
index 6c9da23b1b..d380951e38 100644
--- a/src/wp-includes/theme-templates.php
+++ b/src/wp-includes/theme-templates.php
@@ -72,9 +72,12 @@ function wp_filter_wp_template_unique_post_slug( $override_slug, $slug, $post_ID
  * @access private
  * @since 5.8.0
  *
+ * @global string $_wp_current_template_content
+ *
  * @return void
  */
 function the_block_template_skip_link() {
+	global $_wp_current_template_content;
 
 	// Early exit if not a block theme.
 	if ( ! current_theme_supports( 'block-templates' ) ) {
@@ -82,7 +85,6 @@ function the_block_template_skip_link() {
 	}
 
 	// Early exit if not a block template.
-	global $_wp_current_template_content;
 	if ( ! $_wp_current_template_content ) {
 		return;
 	}