Changeset 52354

Timestamp:

12/11/2021 11:14:17 AM (2 years ago)

Author:

audrasjb

Message:

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.

File:

• trunk/src/wp-includes/blocks.php (modified) (4 diffs)

trunk/src/wp-includes/blocks.php

@@ -1192 +1192 @@
 
 /**
- * Enqueue a stylesheet for a specific block.
+ * Enqueues a stylesheet for a specific block.
  *
  * If the theme has opted-in to separate-styles loading,
@@ -1198 +1198 @@
  * 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
  */
@@ -1221 +1222 @@
      *                        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 ) {
@@ -1276 +1276 @@
  * Allow multiple block styles.
  *
+ * @since 5.9.0
+ *
  * @param array $metadata Metadata for registering a block type.
- *
- * @return array
+ * @return array Metadata for registering a block type.
  */
 function _wp_multiple_block_styles( $metadata ) {