Changeset 54195 for trunk/src/wp-includes/class-wp-block-parser.php

Timestamp:

09/17/2022 05:29:21 PM (4 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.