Changeset 54195

Timestamp:

09/17/2022 05:29:21 PM (2 years ago)

Author:

SergeyBiryukov

Message:

Docs: Revert the WP_Block_Parser documentation changes now.

This commit reverts [54193] and [54194].

It appears that these changes should first be made ​upstream in the Gutenberg respository and then backported to core, as the ​tests fail otherwise.

See #56581.

File:

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

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

@@ -63 +63 @@
      * )
      *
-     * @since 5.0.0
+     * @since 4.2.0
      * @var array
      */
@@ -165 +165 @@
  * Class WP_Block_Parser
  *
- * Parses a document and constructs a list of parsed blocks.
+ * Parses a document and constructs a list of parsed block objects
  *
  * @since 5.0.0
+ * @since 4.0.0 returns arrays not objects, all attributes are arrays
  */
 class WP_Block_Parser {
@@ -192 +193 @@
      *
      * @since 5.0.0
-     * @var array[]
+     * @var WP_Block_Parser_Block[]
      */
     public $output;
@@ -207 +208 @@
      * Empty associative array, here due to PHP quirks
      *
-     * @since 5.0.0
+     * @since 4.4.0
      * @var array empty associative array
      */
@@ -222 +223 @@
      *
      * @param string $document Input document being parsed.
-     * @return array[]
+     * @return WP_Block_Parser_Block[]
      */
     function parse( $document ) {
@@ -395 +396 @@
      * @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
      */
@@ -467 +469 @@
      *
      * @internal
-     * @since 5.0.0
+     * @since 3.9.0
      *
      * @param string $innerHTML HTML content of block.