From adee0cbf6b0fb5535bf7c562ccf23ad4dda09419 Mon Sep 17 00:00:00 2001
From: audrasjb <audrasjb@git.wordpress.org>
Date: Sat, 11 Dec 2021 11:16:03 +0000
Subject: [PATCH] Docs: Docblock adjustments in some 5.9 block related
 functions.

Adds missing `@since` mention to `wp_enqueue_block_style()` and `_wp_multiple_block_styles()`, and a few other minor changes.

Follow-up to [52069].

See #53359.

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


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

diff --git a/wp-includes/blocks.php b/wp-includes/blocks.php
index a649bfe457..0f34aac1df 100644
--- a/wp-includes/blocks.php
+++ b/wp-includes/blocks.php
@@ -1191,15 +1191,16 @@ function get_query_pagination_arrow( $block, $is_next ) {
 }
 
 /**
- * Enqueue a stylesheet for a specific block.
+ * Enqueues a stylesheet for a specific block.
  *
  * If the theme has opted-in to separate-styles loading,
  * then the stylesheet will be enqueued on-render,
  * otherwise when the block inits.
  *
+ * @since 5.9.0
+ *
  * @param string $block_name The block-name, including namespace.
  * @param array  $args       An array of arguments [handle,src,deps,ver,media].
- *
  * @return void
  */
 function wp_enqueue_block_style( $block_name, $args ) {
@@ -1220,8 +1221,7 @@ function wp_enqueue_block_style( $block_name, $args ) {
 	 * @param string $content When the callback is used for the render_block filter,
 	 *                        the content needs to be returned so the function parameter
 	 *                        is to ensure the content exists.
-	 *
-	 * @return string
+	 * @return string Block content.
 	 */
 	$callback = static function( $content ) use ( $args ) {
 		// Register the stylesheet.
@@ -1275,9 +1275,10 @@ function wp_enqueue_block_style( $block_name, $args ) {
 /**
  * Allow multiple block styles.
  *
- * @param array $metadata Metadata for registering a block type.
+ * @since 5.9.0
  *
- * @return array
+ * @param array $metadata Metadata for registering a block type.
+ * @return array Metadata for registering a block type.
  */
 function _wp_multiple_block_styles( $metadata ) {
 	foreach ( array( 'style', 'editorStyle' ) as $key ) {
diff --git a/wp-includes/version.php b/wp-includes/version.php
index 8f1d0d7a8b..df56acbe7c 100644
--- a/wp-includes/version.php
+++ b/wp-includes/version.php
@@ -16,7 +16,7 @@
  *
  * @global string $wp_version
  */
-$wp_version = '5.9-beta2-52353';
+$wp_version = '5.9-beta2-52354';
 
 /**
  * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.