Changeset 57209

Timestamp:

12/20/2023 12:34:34 PM (3 years ago)

Author:

Bernhard Reiter

Message:

HTML API: Apply linting changes to @TODO comments.

Lowercase @TODO comments introduced by [57186], and remove spurious colons after them.

Props dmsnell, TobiasBg, mukesh27, sergeybiryukov, jonsurrell.
Fixes #60060.

Location:

trunk/src/wp-includes/html-api

Files:

• class-wp-html-active-formatting-elements.php (modified) (1 diff)
• class-wp-html-processor.php (modified) (8 diffs)

trunk/src/wp-includes/html-api/class-wp-html-active-formatting-elements.php

@@ -106 +106 @@
                  * > (the order of the attributes does not matter).
                  *
-                 * @TODO: Implement the "Noah's Ark clause" to only add up to three of any given kind of formatting elements to the stack.
+                 * @todo Implement the "Noah's Ark clause" to only add up to three of any given kind of formatting elements to the stack.
                  */
                 // > Add element to the list of active formatting elements.

trunk/src/wp-includes/html-api/class-wp-html-processor.php

@@ -253 +253 @@
                 $p->state->insertion_mode = WP_HTML_Processor_State::INSERTION_MODE_IN_BODY;
 
-                // @TODO: Create "fake" bookmarks for non-existent but implied nodes.
+                // @todo Create "fake" bookmarks for non-existent but implied nodes.
                 $p->bookmarks['root-node']    = new WP_HTML_Span( 0, 0 );
                 $p->bookmarks['context-node'] = new WP_HTML_Span( 0, 0 );
@@ -507 +507 @@
                          * on the stack is a void element, it must be closed.
                          *
-                         * @TODO: Once self-closing foreign elements and BGSOUND are supported,
+                         * @todo Once self-closing foreign elements and BGSOUND are supported,
                          *        they must also be implicitly closed here too. BGSOUND is
                          *        special since it's only self-closing if the self-closing flag
@@ -609 +609 @@
                         case '+BUTTON':
                                 if ( $this->state->stack_of_open_elements->has_element_in_scope( 'BUTTON' ) ) {
-                                        // @TODO: Indicate a parse error once it's possible. This error does not impact the logic here.
+                                        // @todo Indicate a parse error once it's possible. This error does not impact the logic here.
                                         $this->generate_implied_end_tags();
                                         $this->state->stack_of_open_elements->pop_until( 'BUTTON' );
@@ -686 +686 @@
                         case '-SUMMARY':
                                 if ( ! $this->state->stack_of_open_elements->has_element_in_scope( $tag_name ) ) {
-                                        // @TODO: Report parse error.
+                                        // @todo Report parse error.
                                         // Ignore the token.
                                         return $this->step();
@@ -693 +693 @@
                                 $this->generate_implied_end_tags();
                                 if ( $this->state->stack_of_open_elements->current_node()->node_name !== $tag_name ) {
-                                        // @TODO: Record parse error: this error doesn't impact parsing.
+                                        // @todo Record parse error: this error doesn't impact parsing.
                                 }
                                 $this->state->stack_of_open_elements->pop_until( $tag_name );
@@ -718 +718 @@
                                         )
                                 ) {
-                                        // @TODO: Indicate a parse error once it's possible.
+                                        // @todo Indicate a parse error once it's possible.
                                         $this->state->stack_of_open_elements->pop();
                                 }
@@ -738 +738 @@
                                          * This is a parse error; ignore the token.
                                          *
-                                         * @TODO: Indicate a parse error once it's possible.
+                                         * @todo Indicate a parse error once it's possible.
                                          */
                                         return $this->step();
@@ -746 +746 @@
 
                                 if ( $this->state->stack_of_open_elements->current_node()->node_name !== $tag_name ) {
-                                        // @TODO: Record parse error: this error doesn't impact parsing.
+                                        // @todo Record parse error: this error doesn't impact parsing.
                                 }