Changeset 54193

Timestamp:

09/17/2022 04:47:17 PM (2 years ago)

Author:

SergeyBiryukov

Message:

Docs: Correct @since tags for some block parser properties and methods.

This affects:

• WP_Block_Parser::$empty_attrs
• WP_Block_Parser::next_token()
• WP_Block_Parser::freeform()
• WP_Block_Parser_Block::$innerContent

The @since tags referred to early Gutenberg versions instead of WordPress core. These properties and methods were introduced in WordPress 5.0, so 5.0.0 is the correct version.

Some of the other @since tags are removed, as they are related to early Gutenberg development before it was merged into WordPress core, and are not relevant for core.

Follow-up to [43751], [43884], [43955] for the 5.0 branch, [44116], [44261], [44281] for trunk.

Props Chouby.
See #56581.

File:

• trunk/src/wp-includes/class-wp-block-parser.php (modified) (5 diffs)

trunk/src/wp-includes/class-wp-block-parser.php

@@ -63 +63 @@
      * )
      *
-     * @since 4.2.0
+     * @since 5.0.0
      * @var array
      */
@@ -165 +165 @@
  * Class WP_Block_Parser
  *
- * Parses a document and constructs a list of parsed block objects
+ * Parses a document and constructs a list of parsed blocks.
  *
  * @since 5.0.0
- * @since 4.0.0 returns arrays not objects, all attributes are arrays
  */
 class WP_Block_Parser {
@@ -208 +207 @@
      * Empty associative array, here due to PHP quirks
      *
-     * @since 4.4.0
+     * @since 5.0.0
      * @var array empty associative array
      */
@@ -396 +395 @@
      * @internal
      * @since 5.0.0
-     * @since 4.6.1 fixed a bug in attribute parsing which caused catastrophic backtracking on invalid block comments
      * @return array
      */
@@ -469 +467 @@
      *
      * @internal
-     * @since 3.9.0
+     * @since 5.0.0
      *
      * @param string $innerHTML HTML content of block.