Feedback updates.

Co-authored-by: David Herrera <mail@dlh01.info>
Co-authored-by: Jon Surrell <sirreal@users.noreply.github.com>

Author: 3 people

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

@@ -249,31 +249,31 @@
  *
  * ## Tokens and finer-grained processing.
  *
- * It's also possible to scan through every lexical token in
- * the HTML document using the `next_token()` function. This
+ * It's possible to scan through every lexical token in the
+ * HTML document using the `next_token()` function. This
  * alternative form takes no argument and provides no built-in
  * query syntax.
  *
  * Example:
  *
- *      $title        = '(untitled)';
- *      $text_content = '';
+ *      $title = '(untitled)';
+ *      $text  = '';
  *      while ( $processor->next_token() ) {
  *          switch ( $processor->get_token_name() ) {
  *              case '#text':
- *                  $text .= $processor->get_node_text();
+ *                  $text .= $processor->get_modifiable_text();
  *                  break;
  *
  *              case 'BR':
  *                  $text .= "\n";
  *                  break;
  *
  *              case 'TITLE':
- *                  $title = $processor->get_node_text();
+ *                  $title = $processor->get_modifiable_text();
  *                  break;
  *          }
  *      }
- *      return trim( "# {$title}\n\n{$text_content}\n" );
+ *      return trim( "# {$title}\n\n{$text}" );
  *
  * ### Tokens and _modifiable text_.
  *
@@ -301,9 +301,9 @@
  *    style of including Javascript inside of HTML comments to avoid accidentally
  *    closing the SCRIPT from inside a Javascript string. E.g. `console.log( '</script>' )`.
  *  - `TITLE` and `TEXTAREA` whose contents are treated as plaintext and then any
- *    character references are decoded. E.g. "1 &amp;lt; 2 < 3" becomes "1 < 2 < 3".
+ *    character references are decoded. E.g. `1 &lt; 2 < 3` becomes `1 < 2 < 3`.
  *  - `IFRAME`, `NOSCRIPT`, `NOEMBED`, `NOFRAME`, `STYLE` whose contents are treated as
- *    raw plaintext and left as-is. E.g. "1 &amp;lt; 2 < 3" remains "1 &amp;lt; 2 < 3".
+ *    raw plaintext and left as-is. E.g. `1 &lt; 2 < 3` remains `1 &lt; 2 < 3`.
  *
  * #### Other tokens with modifiable text.
  *
@@ -909,9 +909,14 @@ public function next_token() {
 
 		$tag_name = $this->get_tag();
 		if (
+			// Skips SCRIPT data.
 			'SCRIPT' !== $tag_name &&
+
+			// Skips RCDATA data.
 			'TEXTAREA' !== $tag_name &&
 			'TITLE' !== $tag_name &&
+
+			// Skips RAWTEXT data.
 			'IFRAME' !== $tag_name &&
 			'NOEMBED' !== $tag_name &&
 			'NOFRAMES' !== $tag_name &&