From af1f54d6b3cad3ca0e2a3919262653feb84f081e Mon Sep 17 00:00:00 2001
From: Sergey Biryukov <sergeybiryukov.ru@gmail.com>
Date: Thu, 21 Dec 2023 18:36:23 +0000
Subject: [PATCH] Docs: Document some globals in `wp-includes/widgets.php`.

Follow-up to [41555], [50995].

Props upadalavipul.
See #60021.
Built from https://develop.svn.wordpress.org/trunk@57216


git-svn-id: http://core.svn.wordpress.org/trunk@56722 1a063a9b-81f0-0310-95a4-ce76da25c4cd
---
 wp-includes/version.php | 2 +-
 wp-includes/widgets.php | 7 +++++++
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/wp-includes/version.php b/wp-includes/version.php
index 9789a2e029..0d1702b3ed 100644
--- a/wp-includes/version.php
+++ b/wp-includes/version.php
@@ -16,7 +16,7 @@
  *
  * @global string $wp_version
  */
-$wp_version = '6.5-alpha-57215';
+$wp_version = '6.5-alpha-57216';
 
 /**
  * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.
diff --git a/wp-includes/widgets.php b/wp-includes/widgets.php
index c568cbe301..1f17a35808 100644
--- a/wp-includes/widgets.php
+++ b/wp-includes/widgets.php
@@ -1544,6 +1544,8 @@ function wp_map_sidebars_widgets( $existing_sidebars_widgets ) {
  *
  * @since 4.9.0
  *
+ * @global array $wp_registered_widgets
+ *
  * @param array $sidebars_widgets   List of sidebars and their widget instance IDs.
  * @param array $allowed_widget_ids Optional. List of widget IDs to compare against. Default: Registered widgets.
  * @return array Sidebars with allowed widgets.
@@ -1968,6 +1970,9 @@ function wp_assign_widget_to_sidebar( $widget_id, $sidebar_id ) {
  *
  * @since 5.8.0
  *
+ * @global array $wp_registered_widgets
+ * @global array $wp_registered_sidebars
+ *
  * @param string $widget_id Widget ID.
  * @param string $sidebar_id Sidebar ID.
  * @return string
@@ -2034,6 +2039,8 @@ function wp_render_widget( $widget_id, $sidebar_id ) {
  *
  * @since 5.8.0
  *
+ * @global array $wp_registered_widget_controls
+ *
  * @param string $id Widget ID.
  * @return string|null
  */