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
This commit is contained in:
audrasjb 2021-12-11 11:16:03 +00:00
parent f847144952
commit adee0cbf6b
2 changed files with 8 additions and 7 deletions

View File

@ -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 ) {

View File

@ -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.